Get started free
All integrations

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.

20 toolsAPI keyAPI docs

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

  • POSTcreate_contact

    Creates a contact and optionally links it to an inbox.

  • DELETEdelete_contact

    Permanently deletes a contact together with its conversations.

  • GETget_contact

    Returns a single contact and its inbox links.

  • GETlist_contacts

    Lists account contacts with sorting and page number paging.

  • GETsearch_contacts

    Finds contacts matching a term across name, identifier, email and phone number.

  • PUTupdate_contact

    Updates a contact's name, email, phone, identifier or custom attributes.

Conversation, 6 operations

  • POSTcreate_conversation

    Opens a conversation for a contact on an inbox, optionally with a first message.

  • GETget_conversation

    Returns a single conversation with its status, labels and latest message.

  • GETlist_contact_conversations

    Returns all conversations of a single contact across inboxes.

  • GETlist_conversations

    Lists an account's conversations, newest activity first, filtered by status and assignee.

  • POSTtoggle_conversation_priority

    Sets a conversation's priority, or clears it with none.

  • POSTtoggle_conversation_status

    Moves a conversation to open, resolved, pending or snoozed.

Label, 3 operations

  • POSTadd_conversation_labels

    Applies label titles to a conversation, replacing the existing set.

  • GETlist_conversation_labels

    Returns the label titles applied to one conversation.

  • GETlist_labels

    Lists the labels defined on the account with their colours.

Message, 2 operations

  • POSTcreate_message

    Posts a reply, or a private internal note, into a conversation.

  • GETlist_messages

    Reads a conversation's messages, oldest first, with cursoring by message id.

Agent, 1 operation

  • GETlist_agents

    Lists the account's agents with role and availability.

Inbox, 1 operation

  • GETlist_inboxes

    Lists the account's inboxes with their channel type and settings.

Team, 1 operation

  • GETlist_teams

    Lists 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 Code
claude mcp add --transport http livecontext https://livecontext.ai/mcp --header "X-API-Key: YOUR_API_KEY"
Codex (~/.codex/config.toml)
[mcp_servers.livecontext]
url = "https://livecontext.ai/mcp"

[mcp_servers.livecontext.http_headers]
"X-API-Key" = "YOUR_API_KEY"
Cursor, Claude Desktop and other JSON configs
{
  "mcpServers": {
    "livecontext": {
      "type": "http",
      "url": "https://livecontext.ai/mcp",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Set up the MCP server step by step

How to connect Chatwoot

  1. Create your workspace

    Sign up free. Nothing to install.

  2. 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.

  3. 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.

Popular integrations

Browse the whole catalog