Skip to content
MCP server

Chatwoot MCP by usefulapi

Read conversations and contacts; add replies or notes, set status and assign in Chatwoot.

Install
Runs
Remotely
Version
1.7.0
Listing updated
4 days ago

About Chatwoot MCP by usefulapi

Chatwoot MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http chatwoot https://chatwoot.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://chatwoot.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "chatwoot": {
      "url": "https://chatwoot.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "chatwoot": {
      "type": "http",
      "url": "https://chatwoot.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "chatwoot": {
      "serverUrl": "https://chatwoot.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "chatwoot": {
      "type": "http",
      "url": "https://chatwoot.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (18)

Read directly from the server.

chatwoot_get_account
Get the configured Chatwoot account: name, locale, features and plan. Chatwoot API: GET /api/v1/accounts/{account_id}.
chatwoot_list_conversations
List conversations, 25 per page, filtered by status, assignee, inbox, team, labels or a text query. Chatwoot API: GET /api/v1/accounts/{account_id}/conversations.
chatwoot_get_conversation_counts
Get the open, unassigned and total conversation counts for a status, inbox or team. Chatwoot API: GET /api/v1/accounts/{account_id}/conversations/meta.
chatwoot_get_conversation
Get one conversation with its status, priority, assignee, team, labels and contact. Chatwoot API: GET .../conversations/{conversation_id}.
chatwoot_list_messages
List the messages of one conversation, oldest first. Chatwoot API: GET .../conversations/{conversation_id}/messages.
chatwoot_list_contacts
List resolved contacts (those with an email, phone number or identifier), 15 per page. Chatwoot API: GET .../contacts.
chatwoot_search_contacts
Search resolved contacts by a text key (name, email or phone). Chatwoot API: GET .../contacts/search.
chatwoot_get_contact
Get one contact with its attributes, labels and custom attributes. Chatwoot API: GET .../contacts/{id}.
chatwoot_list_contact_conversations
List all conversations of one contact. Chatwoot API: GET .../contacts/{id}/conversations.
chatwoot_list_labels
List all labels of the account. Chatwoot API: GET .../labels.
chatwoot_list_inboxes
List the inboxes (channels) of the account. Chatwoot API: GET .../inboxes.
chatwoot_list_agents
List the agents of the account with their roles. Chatwoot API: GET .../agents.
chatwoot_list_teams
List the teams of the account. Chatwoot API: GET .../teams.
chatwoot_list_canned_responses
List the saved reply templates (canned responses) of the account. Chatwoot API: GET .../canned_responses.
chatwoot_send_message
Add a message to a conversation. Default: a private note that the customer never sees. Set private to false to send a reply that the customer receives by email or chat. Chatwoot API: POST .../conversations/{conversation_id}/messages.
chatwoot_set_conversation_status
Set a conversation to open, resolved, pending or snoozed. For snoozed, snoozed_until is a Unix time in seconds (optional). Chatwoot API: POST .../conversations/{conversation_id}/toggle_status.
chatwoot_set_conversation_priority
Set a conversation priority: urgent, high, medium, low, or none (clears it). Chatwoot API: PATCH .../conversations/{conversation_id}.
chatwoot_assign_conversation
Assign a conversation to an agent (assignee_id) or to a team (team_id). Give exactly one. Chatwoot API: POST .../conversations/{conversation_id}/assignments.

Chatwoot MCP by usefulapi FAQ

How do I add Chatwoot MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http chatwoot https://chatwoot.usefulapi.io/mcp