Chatwoot integration
Chatwoot open-source customer engagement suite, application API v1. Drive a Chatwoot account the way an agent would: list and filter conversations across inboxes, open one, read and post messages (public replies or private notes), change status and priority, label conversations, and manage the contact database with create, read, update, delete, search and per-contact conversation history. Also exposes the account directory: inboxes, labels, agents and teams. Works against Chatwoot Cloud and against any self-hosted installation, the host is part of the credential.
Say what should happen.
The workflow builds itself.
Common Chatwoot use cases
- exporting the contact base
- triaging the unassigned queue
- honouring a data erasure request
- resolving the inbox to create a contact on
- routing a conversation to the billing team
- sending the drafted answer to the customer
- validating a label title before applying it
- picking an online agent to assign a conversation to
- tagging a conversation by product area for later reporting
- escalating a conversation that breached its response target
What you can do with Chatwoot
Each of these is one operation on one endpoint, available both as a workflow step and as a tool an AI agent can call on its own. Nothing bundles several operations into one action, so what a run did stays readable afterwards.
Most endpoints run on the free plan. A few, mainly the ones that publish on your behalf, need a paid plan.
Contact, 6 operations
create_contactCreate contactPOSTCreates a contact and optionally links it to an inbox.delete_contactDelete contactDELETEPermanently deletes a contact together with its conversations.get_contactGet contactGETReturns a single contact and its inbox links.list_contactsList contactsGETLists account contacts with sorting and page number paging.search_contactsSearch contactsGETFinds contacts matching a term across name, identifier, email and phone number.update_contactUpdate contactPUTUpdates a contact's name, email, phone, identifier or custom attributes.
Conversation, 6 operations
create_conversationCreate conversationPOSTOpens a conversation for a contact on an inbox, optionally with a first message.get_conversationGet conversationGETReturns a single conversation with its status, labels and latest message.list_contact_conversationsList contact conversationsGETReturns all conversations of a single contact across inboxes.list_conversationsList conversationsGETLists an account's conversations, newest activity first, filtered by status and assignee.toggle_conversation_priorityToggle conversation priorityPOSTSets a conversation's priority, or clears it with none.toggle_conversation_statusToggle conversation statusPOSTMoves a conversation to open, resolved, pending or snoozed.
Label, 3 operations
add_conversation_labelsAdd conversation labelsPOSTApplies label titles to a conversation, replacing the existing set.list_conversation_labelsList conversation labelsGETReturns the label titles applied to one conversation.list_labelsList labelsGETLists the labels defined on the account with their colours.
Message, 2 operations
create_messageCreate messagePOSTPosts a reply, or a private internal note, into a conversation.list_messagesList messagesGETReads a conversation's messages, oldest first, with cursoring by message id.
Agent, 1 operation
list_agentsList agentsGETLists the account's agents with role and availability.
Inbox, 1 operation
list_inboxesList inboxesGETLists the account's inboxes with their channel type and settings.
Team, 1 operation
list_teamsList teamsGETLists the account's teams and whether the token owner belongs to them.
Use Chatwoot from Claude Code, Cursor or Codex
Connect Chatwoot in LiveContext, create an API key in Settings, then add the LiveContext MCP server to your client. Its Chatwoot operations become tools the client can call, next to every other integration you connected.
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"
[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"{
"mcpServers": {
"livecontext": {
"type": "http",
"url": "https://livecontext.ai/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY"
}
}
}
}How to connect Chatwoot
- Create your workspace
Sign up free. Nothing to install.
- Connect Chatwoot once
Add your Chatwoot connection in Settings. Every tool from this integration reuses it, and secrets are encrypted at rest and visible only to you.
- Describe the job in chat
The workflow builds itself in front of you and picks the endpoints it needs. Drag the steps yourself on the canvas whenever you would rather be explicit.
Chatwoot integration FAQ
What can you do with the Chatwoot integration?
LiveContext exposes 20 operations on Chatwoot, covering contact, conversation, label and message. Common uses include exporting the contact base, triaging the unassigned queue and honouring a data erasure request.
