Connectors · MSP & PSA

Chatwoot MCP server for AI agents.

actionlake is an MCP gateway: one remote MCP server that connects Claude and other MCP clients to Chatwoot and the rest of your systems. It gives your agent 155 Chatwoot actions (67 reads, 67 writes and 21 that wait for a confirmation) and holds the Chatwoot credential itself, so the agent never does. It paces Chatwoot's limits and records every call.

Connect Chatwoot free See pricing

100,000 free calls a month. No card, no email, no password: press Start a free sandbox on the next screen and keep the key it shows you.

claude mcp add --transport http actionlake https://connect.actionlake.com/mcp

155actionsin one signed file
67readlook, never change
67writecreate and update
21wait for a yesdestructive, confirmed first

Set up

Connect Chatwoot in three steps.

01
Add actionlake to Claude.
Run the command once in Claude Code; its consent page can create a free sandbox: 100,000 calls a month, no card. In the Claude app, add a custom connector with the URL below and paste your key on the consent page. Creating a new sandbox from the Claude app is not yet tested by us.
https://connect.actionlake.com/mcp
02
Connect Chatwoot.
API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead. actionlake stores what you paste write-only, sealed under your tenant's key.
- api_access_tokenChatwoot access token: a user's token from Profile Settings > Access Token for the Application API, or a Platform…
- account_idYour Chatwoot account id
- hostWhere your Chatwoot lives: your host
```
account { op: "connections.requirements", service: "chatwoot" }
# free: exactly what to paste, and what is found for you
```

Make the first call. Check before a write.

Ask in plain words; Claude picks the action. Before anything changes, check validates the call and prices it, for free.

do    { action: "chatwoot.agents.list" }# list agents in account · read · 1 upstream callcheck { action: "chatwoot.agents.create", input: { … } }# free: inputs, permissions, cost and confirmations, nothing sent

Chatwoot at a glance

Sign-in: API key. No consent screen: your agent can connect it for you, but the key then passes through your chat. To keep it out of the model's context, paste it in the console instead.
You provide: api_access_token
Setup fields: account_idhost
Limits we pace to: 3,000 calls a minute, per connection
API covered: Chatwoot API (OpenAPI 3.1, swagger/swagger.json on the develop branch)app.chatwoot.com
Built from: Chatwoot's documentation, read 23 October 2026OpenAPI spec (GitHub)developers.chatwoot.com
Service file: Version 1.0.0, signed (Ed25519)
Cached reads: 64 of 67 reads, for up to 5 minutes; a write clears what it affects
Shared entities: 6, so ask can line Chatwoot up with your other systems
Data: Processed and stored in Sydney, Australia. No US region yet

Capabilities

What an AI agent can do in Chatwoot.

155 actions in 39 areas. Every one carries its effect, so a key can allow the reads and hold the rest.

67readlook, never change
67writecreate and update
21destructivewait for a confirmation

Conversations
14
5 read · 8 write · 1 destructive
Conversations List · Create New Conversation · Conversation Details · Update Conversation
Contacts
10
6 read · 2 write · 2 destructive
List Contacts · Create Contact · Show Contact · Update Contact
Inboxes
7
4 read · 3 write · 0 destructive
List all inboxes · Create an inbox · Get an inbox · Update Inbox
Reports
7
7 read · 0 write · 0 destructive
Account Conversation Metrics · Agent Conversation Metrics · Get first response time distribution by channel · Get inbox-label matrix report
Client conversations
6
2 read · 4 write · 0 destructive
Create a conversation · List all conversations · Get a single conversation · Resolve a conversation
Platform users
6
2 read · 3 write · 1 destructive
Create a User · Get User Access Token · Get an user details · Get User SSO Link
Agent bots
5
2 read · 2 write · 1 destructive
Create an Agent Bot · List all AgentBots · Get an agent bot details · Update an agent bot
Automation rules
5
2 read · 2 write · 1 destructive
Add a new automation rule · List all automation rules in an account · Get an automation rule details · Update automation rule in Account

31 more areas · 95 actions

Campaigns 5
Custom attribute definitions 5
Custom filters 5
Labels 5
Platform agent bots 5
Teams 5
Agents 4
Canned responses 4
Inbox members 4
Messages 4
Platform accounts 4
Portals 4
Summary reports 4
Team members 4
Webhooks 4
Client contacts 3
Client messages 3
Integration hooks 3
Platform account users 3
Account 2
Branded email layout 2
Contact labels 2
Conversation labels 2
Profile 2
Audit logs 1
Client inbox 1
Contact inboxes 1
Integration apps 1
Portal articles 1
Portal categories 1
Reporting events 1

Top actions

The Chatwoot API, shaped for agents.

The ids your agent types, what each does, and the one name it shares with other systems. 56 of Chatwoot's 56 action names are shared with at least one other connector, so an agent learns them once.

Action	What it does	Effect	Same name in
`chatwoot.agents.list`List Agents in Account	List Agents in Account.	read	`identity.user.list`474 connectors
`chatwoot.teams.list`List all teams	List all teams.	read	`identity.group.list`262 connectors
`chatwoot.inboxes.list`List all inboxes	List all inboxes.	read	`service.queue.list`21 connectors
`chatwoot.conversations.list`Conversations List	Conversations List.	read	`service.conversation.list`19 connectors
`chatwoot.contacts.list`List Contacts	List Contacts.	read	`crm.contact.list`177 connectors
`chatwoot.agents.create`Add a New Agent	Add a New Agent.	write	`identity.user.create`262 connectors
`chatwoot.teams.create`Create a team	Create a team.	write	`identity.group.create`205 connectors
`chatwoot.agents.delete`Remove an Agent from Account	Remove an Agent from Account.	destructive	`identity.user.delete`253 connectors
`chatwoot.inboxes.create`Create an inbox	Create an inbox.	write	`service.queue.create`14 connectors
`chatwoot.conversations.create`Create New Conversation	Create New Conversation.	write	`service.conversation.create`13 connectors
`chatwoot.contacts.create`Create Contact	Create Contact.	write	`crm.contact.create`161 connectors
`chatwoot.labels.create`Create a label	Create a label.	write	`crm.tag.create`49 connectors

Try it

Prompts to paste into Claude.

Each one names the Chatwoot actions it will call, so you know what it reads and what it changes before you send it.

Readread
Find the Chatwoot contacts with no email address, so we can clean them up.
callschatwoot.contacts.list
Writewrite
Add a New Agent in Chatwoot. Show me exactly what you will send before you save it.
callschatwoot.agents.create
Across systemsread
Which contacts are in both Chatwoot and NetSuite, and how many are in only one of them?
callschatwoot.contacts.listnetsuite.views.contacts

Across your systems

Chatwoot, joined to the rest of your business.

One ask fetches from Chatwoot and another system, joins the rows on the same customer on our side, and hands your agent the answer, not every row.

Which contacts are in both Chatwoot and NetSuite, and how many are in only one of them?
chatwoot.contacts.list + netsuite.views.contacts, on crm.contact · NetSuite
Which contacts are in both Chatwoot and HubSpot CRM, and how many are in only one of them?
chatwoot.contacts.list + hubspot_crm.contacts.list, on crm.contact · HubSpot CRM

Also mapped by other connectorsidentity.user 517identity.group 239crm.contact 192crm.tag 47service.queue 14service.conversation 12

ask

ask {  intent: "which contacts are in both Chatwoot and NetSuite, and how many are in only one of them",  steps: [    { action: "chatwoot.contacts.list", as: "people", input: {}, limit: 100, max_pages: 5 },    { action: "netsuite.views.contacts", as: "people2", input: {}, limit: 100, max_pages: 5 },    { join: {        left: "people",        right: "people2",        on: "crm.contact",        group_by: "people.email",        select: ["people.email", "count(people2.id) as in_netsuite"]    } }  ]}

Example. Run it through check first: it validates the steps and prices them, and it is free.

Governance for Chatwoot

Destructive actions wait for a yes.

21 Chatwoot actions are destructive. These are all of them:

Remove an Agent from Accountchatwoot.agents.delete
Delete a teamchatwoot.teams.delete
Delete Contactchatwoot.contacts.delete
Delete a labelchatwoot.labels.delete
Remove a Canned Response from Accountchatwoot.canned_responses.delete
Merge Contactschatwoot.contacts.merge
Delete a messagechatwoot.messages.delete
Remove an Agent from Teamchatwoot.team_members.remove
Delete a webhookchatwoot.webhooks.delete
Remove an Agent from Inboxchatwoot.inbox_members.remove
Destroy Custom Attributeschatwoot.conversations.delete_custom_attributes
Delete a campaignchatwoot.campaigns.delete
Delete an AgentBotchatwoot.agent_bots.delete
Delete a custom filterchatwoot.custom_filters.delete
Delete a Userchatwoot.platform_users.delete
Remove an automation rule from accountchatwoot.automation_rules.delete
Delete an Integration Hookchatwoot.integration_hooks.delete
Delete an Accountchatwoot.platform_accounts.delete
Delete an AgentBotchatwoot.platform_agent_bots.delete
Delete an Account Userchatwoot.platform_account_users.delete
Remove a custom attribute from accountchatwoot.custom_attribute_definitions.delete

A destructive action runs only with confirm: true. Under the human policy the agent cannot confirm for itself: the run stops until a named person approves, in the console or from a signed link in an email. The cap on a key is refused before the call is sent, never after.

dochatwoot.agents.deleteconfirm_policy: human

Remove an Agent from Account?

intent: the user asked me to remove an Agent from Account

run suspended · waiting for a named person · key chatwoot-agent cannot confirm itself

In the console, or from an emailed signed link.

a key for this connector

account {  op: "keys.create", name: "chatwoot-agent",  allowed_actions: ["chatwoot.*"], cap_calls: 2000,  confirm_policy: "human_for_writes",  approval_rules: [    { match: "chatwoot.agents.delete", approver: "[email protected]" },    { match: "chatwoot.teams.delete", approver: "[email protected]" },    { match: "chatwoot.contacts.delete", approver: "[email protected]" }  ]}

Illustrative. Scoped to Chatwoot only, capped at 2,000 upstream calls, every write confirmed, and the destructive ones approved by a named person.

Cost

What Chatwoot costs on actionlake.

Every Chatwoot action is one upstream call, the only thing actionlake bills. Searching, check, cost, account and any call Chatwoot refused with 401, 403, 429 or a 5xx are free. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

1upstream call per actionall 155 Chatwoot actions
155actions pageeach page of a long list is one call
64reads can be cacheda cache hit costs nothing
100,000calls a month, freepaid plans from US$49 a month for 250,000

See pricing

Action index

Every Chatwoot action.

155 actions by area: the id your agent calls, what it does, and its effect.

Conversations14

chatwoot.conversations.assignAssign Conversationwrite
chatwoot.conversations.createCreate New Conversationwrite
chatwoot.conversations.delete_custom_attributesDestroy Custom Attributesdestructive
chatwoot.conversations.filterConversations Filterread
chatwoot.conversations.getConversation Detailsread
chatwoot.conversations.get_countsGet Conversation Countsread
chatwoot.conversations.listConversations Listread
chatwoot.conversations.list_reporting_eventsConversation Reporting Eventsread
chatwoot.conversations.toggle_priorityToggle Prioritywrite
chatwoot.conversations.toggle_statusToggle Statuswrite
chatwoot.conversations.toggle_typing_statusToggle Typing Statuswrite
chatwoot.conversations.updateUpdate Conversationwrite
chatwoot.conversations.update_custom_attributesUpdate Custom Attributeswrite
chatwoot.conversations.update_last_seenUpdate Last Seenwrite

Contacts10

chatwoot.contacts.createCreate Contactwrite
chatwoot.contacts.deleteDelete Contactdestructive
chatwoot.contacts.filterContact Filterread
chatwoot.contacts.getShow Contactread
chatwoot.contacts.listList Contactsread
chatwoot.contacts.list_contactable_inboxesGet Contactable Inboxesread
chatwoot.contacts.list_conversationsContact Conversationsread
chatwoot.contacts.mergeMerge Contactsdestructive
chatwoot.contacts.searchSearch Contactsread
chatwoot.contacts.updateUpdate Contactwrite

Inboxes7

chatwoot.inboxes.createCreate an inboxwrite
chatwoot.inboxes.getGet an inboxread
chatwoot.inboxes.get_agent_botShow Inbox Agent Botread
chatwoot.inboxes.listList all inboxesread
chatwoot.inboxes.list_message_templatesList WhatsApp message templatesread
chatwoot.inboxes.set_agent_botAdd or remove agent botwrite
chatwoot.inboxes.updateUpdate Inboxwrite

Reports7

chatwoot.reports.get_account_conversation_metricsAccount Conversation Metricsread
chatwoot.reports.get_agent_conversation_metricsAgent Conversation Metricsread
chatwoot.reports.get_first_response_time_distributionGet first response time distribution by channelread
chatwoot.reports.get_inbox_label_matrixGet inbox-label matrix reportread
chatwoot.reports.get_metric_timeseriesGet Account reportsread
chatwoot.reports.get_outgoing_messages_countGet outgoing messages count grouped by entityread
chatwoot.reports.get_summaryGet Account reports summaryread

Client conversations6

chatwoot.client_conversations.createCreate a conversationwrite
chatwoot.client_conversations.getGet a single conversationread
chatwoot.client_conversations.listList all conversationsread
chatwoot.client_conversations.resolveResolve a conversationwrite
chatwoot.client_conversations.toggle_typingToggle typing statuswrite
chatwoot.client_conversations.update_last_seenUpdate last seen and mark messages readwrite

Platform users6

chatwoot.platform_users.createCreate a Userwrite
chatwoot.platform_users.create_tokenGet User Access Tokenwrite
chatwoot.platform_users.deleteDelete a Userdestructive
chatwoot.platform_users.getGet an user detailsread
chatwoot.platform_users.get_sso_urlGet User SSO Linkread
chatwoot.platform_users.updateUpdate a userwrite

Agent bots5

chatwoot.agent_bots.createCreate an Agent Botwrite
chatwoot.agent_bots.deleteDelete an AgentBotdestructive
chatwoot.agent_bots.getGet an agent bot detailsread
chatwoot.agent_bots.listList all AgentBotsread
chatwoot.agent_bots.updateUpdate an agent botwrite

Automation rules5

chatwoot.automation_rules.createAdd a new automation rulewrite
chatwoot.automation_rules.deleteRemove an automation rule from accountdestructive
chatwoot.automation_rules.getGet an automation rule detailsread
chatwoot.automation_rules.listList all automation rules in an accountread
chatwoot.automation_rules.updateUpdate automation rule in Accountwrite

Campaigns5

chatwoot.campaigns.createCreate a campaignwrite
chatwoot.campaigns.deleteDelete a campaigndestructive
chatwoot.campaigns.getGet a campaignread
chatwoot.campaigns.listList campaignsread
chatwoot.campaigns.updateUpdate a campaignwrite

Custom attribute definitions5

chatwoot.custom_attribute_definitions.createAdd a new custom attributewrite
chatwoot.custom_attribute_definitions.deleteRemove a custom attribute from accountdestructive
chatwoot.custom_attribute_definitions.getGet a custom attribute detailsread
chatwoot.custom_attribute_definitions.listList all custom attributes in an accountread
chatwoot.custom_attribute_definitions.updateUpdate custom attribute in Accountwrite

Custom filters5

chatwoot.custom_filters.createCreate a custom filterwrite
chatwoot.custom_filters.deleteDelete a custom filterdestructive
chatwoot.custom_filters.getGet a custom filter detailsread
chatwoot.custom_filters.listList all custom filtersread
chatwoot.custom_filters.updateUpdate a custom filterwrite

Labels5

chatwoot.labels.createCreate a labelwrite
chatwoot.labels.deleteDelete a labeldestructive
chatwoot.labels.getGet a labelread
chatwoot.labels.listList all labelsread
chatwoot.labels.updateUpdate a labelwrite

Platform agent bots5

chatwoot.platform_agent_bots.createCreate an Agent Botwrite
chatwoot.platform_agent_bots.deleteDelete an AgentBotdestructive
chatwoot.platform_agent_bots.getGet an agent bot detailsread
chatwoot.platform_agent_bots.listList all AgentBotsread
chatwoot.platform_agent_bots.updateUpdate an agent botwrite

Teams5

chatwoot.teams.createCreate a teamwrite
chatwoot.teams.deleteDelete a teamdestructive
chatwoot.teams.getGet a team detailsread
chatwoot.teams.listList all teamsread
chatwoot.teams.updateUpdate a teamwrite

Agents4

chatwoot.agents.createAdd a New Agentwrite
chatwoot.agents.deleteRemove an Agent from Accountdestructive
chatwoot.agents.listList Agents in Accountread
chatwoot.agents.updateUpdate Agent in Accountwrite

Canned responses4

chatwoot.canned_responses.createAdd a New Canned Responsewrite
chatwoot.canned_responses.deleteRemove a Canned Response from Accountdestructive
chatwoot.canned_responses.listList all Canned Responses in an Accountread
chatwoot.canned_responses.updateUpdate Canned Response in Accountwrite

Inbox members4

chatwoot.inbox_members.addAdd a New Agentwrite
chatwoot.inbox_members.listList Agents in Inboxread
chatwoot.inbox_members.removeRemove an Agent from Inboxdestructive
chatwoot.inbox_members.updateUpdate Agents in Inboxwrite

Messages4

chatwoot.messages.createCreate New Messagewrite
chatwoot.messages.deleteDelete a messagedestructive
chatwoot.messages.listGet messagesread
chatwoot.messages.update_statusUpdate message statuswrite

Platform accounts4

chatwoot.platform_accounts.createCreate an Accountwrite
chatwoot.platform_accounts.deleteDelete an Accountdestructive
chatwoot.platform_accounts.getGet an account detailsread
chatwoot.platform_accounts.updateUpdate an accountwrite

Portals4

chatwoot.portals.createAdd a new portalwrite
chatwoot.portals.getGet a portal detailsread
chatwoot.portals.listList all portals in an accountread
chatwoot.portals.updateUpdate a portalwrite

Summary reports4

chatwoot.summary_reports.get_agentGet conversation statistics grouped by agentread
chatwoot.summary_reports.get_channelGet conversation statistics grouped by channel typeread
chatwoot.summary_reports.get_inboxGet conversation statistics grouped by inboxread
chatwoot.summary_reports.get_teamGet conversation statistics grouped by teamread

Team members4

chatwoot.team_members.addAdd a New Agentwrite
chatwoot.team_members.listList Agents in Teamread
chatwoot.team_members.removeRemove an Agent from Teamdestructive
chatwoot.team_members.updateUpdate Agents in Teamwrite

Webhooks4

chatwoot.webhooks.createAdd a webhookwrite
chatwoot.webhooks.deleteDelete a webhookdestructive
chatwoot.webhooks.listList all webhooksread
chatwoot.webhooks.updateUpdate a webhook objectwrite

Client contacts3

chatwoot.client_contacts.createCreate a contactwrite
chatwoot.client_contacts.getGet a contactread
chatwoot.client_contacts.updateUpdate a contactwrite

Client messages3

chatwoot.client_messages.createCreate a messagewrite
chatwoot.client_messages.listList all messagesread
chatwoot.client_messages.updateUpdate a messagewrite

Integration hooks3

chatwoot.integration_hooks.createCreate an integration hookwrite
chatwoot.integration_hooks.deleteDelete an Integration Hookdestructive
chatwoot.integration_hooks.updateUpdate an Integration Hookwrite

Platform account users3

chatwoot.platform_account_users.createCreate an Account Userwrite
chatwoot.platform_account_users.deleteDelete an Account Userdestructive
chatwoot.platform_account_users.listList all Account Usersread

Account2

chatwoot.account.getGet account detailsread
chatwoot.account.updateUpdate accountwrite

Branded email layout2

chatwoot.branded_email_layout.getGet account branded email layoutread
chatwoot.branded_email_layout.updateUpdate account branded email layoutwrite

Contact labels2

chatwoot.contact_labels.listList Labelsread
chatwoot.contact_labels.setAdd Labelswrite

Conversation labels2

chatwoot.conversation_labels.listList Labelsread
chatwoot.conversation_labels.setAdd Labelswrite

Profile2

chatwoot.profile.getFetch user profileread
chatwoot.profile.updateUpdate user profilewrite

Audit logs1

chatwoot.audit_logs.listList Audit Logs in Accountread

Client inbox1

chatwoot.client_inbox.getInbox detailsread

Contact inboxes1

chatwoot.contact_inboxes.createCreate contact inboxwrite

Integration apps1

chatwoot.integration_apps.listList all the Integrationsread

Portal articles1

chatwoot.portal_articles.createAdd a new articlewrite

Portal categories1

chatwoot.portal_categories.createAdd a new categorywrite

Reporting events1

chatwoot.reporting_events.listAccount Reporting Eventsread

Questions

The Chatwoot MCP server, answered.

Is there a Chatwoot MCP server for Claude?

Yes. actionlake is an MCP gateway: a remote MCP server that gives Claude, or another MCP client, 155 Chatwoot actions across conversations, contacts, inboxes and reports, through the same eight tools it uses for every other connector. actionlake is independent; it is not made or endorsed by Chatwoot.

What do I need to connect Chatwoot?

Chatwoot access token: a user's token from Profile Settings > Access Token for the Application API, or a Platform…. Plus your account id and your host. The free call account { op: "connections.requirements", service: "chatwoot" } lists exactly what to paste.

Can an AI agent delete or change things in Chatwoot?

Only if its key allows it, and only with an explicit confirmation. 21 Chatwoot actions are destructive, including remove an Agent from Account, delete a team and delete Contact. Each runs only with confirm: true. Under the human confirm policy, or an approval rule on the key, the run waits until a named person approves it.

Will an AI agent use up my Chatwoot API limit?

actionlake paces every call to the limits in the Chatwoot service file: 3,000 calls a minute per connection. Repeated reads are answered from cache (64 Chatwoot actions can be), which never reaches Chatwoot.

What does a Chatwoot action cost?

One upstream call, the only unit actionlake bills. A list that pages bills one call per page (155 Chatwoot actions page). Cache hits, searches, dry runs and calls Chatwoot refused with 401, 403, 429 or a 5xx are free. The Free plan includes 100,000 calls a month with no card. Paid plans start at US$49 a month for 250,000 calls, with overage from US$0.30 down to US$0.18 per 1,000.

Which Chatwoot API does it cover?

The Chatwoot API (OpenAPI 3.1, swagger/swagger.json on the develop branch) at app.chatwoot.com by default, or the base URL set when you connect. It is built from Chatwoot's documentation as read on 23 October 2026. 155 actions in 39 areas, each one in the signed service file (version 1.0.0).

Can I combine Chatwoot with my other systems?

Yes. ask joins Chatwoot to NetSuite or HubSpot CRM on the same customer and returns the answer rather than every row. Chatwoot maps crm.contact, which 192 other connectors also map.

Does actionlake keep my Chatwoot data, and where?

actionlake processes and stores data in Sydney, Australia; there is no US region yet. Reads may be cached for up to 5 minutes, and a write clears the reads it affects. Each run's request and response is kept, sealed, for your plan's trace window: 1 day on Free, 3 days on Starter, 7 days on Pro, 14 days on Team, 30 days on Business and 30 days on Enterprise. Your Chatwoot credential is sealed under your tenant's key, never logged and never returned. Your traffic is not used to train models.

Which AI clients can use it?

Claude Code, tested by us end to end, and the Claude app as a custom connector, tested by us with an existing key. Other MCP clients that support remote servers over Streamable HTTP (MCP revisions 2025-06-18 and 2025-11-25) and OAuth dynamic client registration, or a bearer header, should connect the same way; we have not tested them. Or plain REST, under the same action names.

Give your agent Chatwoot today.

Connect Chatwoot free See pricing

Start free - 100,000 calls/month, no card. No signup. Hard caps on every key. Cached answers are free.

Chatwoot MCP server for AI agents.

Connect Chatwoot in three steps.

Add actionlake to Claude.

Connect Chatwoot.

Make the first call. Check before a write.

What an AI agent can do in Chatwoot.

Conversations

Contacts

Inboxes

Reports

Client conversations

Platform users

Agent bots

Automation rules