MCP server
Chatwoot MCP by usefulapi
Read conversations and contacts; add replies or notes, set status and assign in Chatwoot.
- 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/mcpAdd to Settings → Connectors → Add custom connector
https://chatwoot.usefulapi.io/mcpInstall 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