Chatwoot MCP by usefulapi

io.usefulapiPublished by usefulapi.ioOfficial publisherv1.3.4Updated Nov 7, 2026

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

The publisher's own server: Ably MCP by usefulapi

VerifiedStreamable HTTPWeb executableCommunication & CollaborationBusiness & Commerce

Overview

AI-generated overview

Hosted Chatwoot MCP that lets an assistant read support conversations and contacts, reply or add private notes, and set status, priority and assignment.

What you can do
  • Read account details, conversation lists and counts, single conversations with their messages, and inboxes, agents, teams, labels and canned responses.
  • Search and inspect contacts, including their attributes and all conversations.
  • Add a message to a conversation, either a private note or a customer-visible reply.
  • Set conversation status (open, resolved, pending, snoozed), priority, and assign to an agent or team.
  • Check monthly tool-call usage, request a missing feature, and manage a paid subscription.
When to use it
Useful when you want an assistant to triage a Chatwoot support inbox: find unassigned or open conversations, summarize a customer's history, draft replies or notes, and route conversations to the right agent or team without switching tools.
Requirements
A remote MCP endpoint added by URL only; no local install. Sign-in is via OAuth, and on first connect you supply a Chatwoot access token and your Account ID, which the server stores per user. A free plan allows 50 tool calls per month; paid plans are available.
Before you install
Write tools change Chatwoot data: sending a message with private set to false delivers a reply the customer actually receives, and status, priority and assignment changes are visible to the team. The server stores your Chatwoot access token, so treat that credential as sensitive. Paid plans involve payment links and subscriptions; cancellation runs to the end of the paid period with no refund for the current period.

Installation

In SourceWeft

  1. Open Chatwoot MCP by usefulapi in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.usefulapi%2Fchatwoot/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

Chatwoot MCP by usefulapi

Use your Chatwoot account from Claude, Cursor, or any MCP client. Read conversations, contacts and inboxes, add replies or private notes, set status or priority, and assign conversations. Hosted, no local install: connect with your own credentials.

Live endpoint: https://chatwoot.usefulapi.io/mcp · Homepage: https://usefulapi.io

Connect

  • Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste https://chatwoot.usefulapi.io/mcp.
  • Claude Code: claude mcp add --transport http chatwoot https://chatwoot.usefulapi.io/mcp, then run /mcp to log in.
  • VS Code: Add to VS Code.
  • Cursor and other clients: add the URL as a remote MCP server:
json
{  "mcpServers": {    "chatwoot": {      "url": "https://chatwoot.usefulapi.io/mcp"    }  }}

Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Chatwoot credentials.

Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/chatwoot/

On first connect you provide a Chatwoot access token (Profile Settings → Access Token) and your Account ID (the number after /app/accounts/ in your Chatwoot URL). The server validates it and stores it per user. No keys go in config files.

Tools

ToolTypeWhat it does
chatwoot_get_accountreadGet account
chatwoot_list_conversationsreadList conversations
chatwoot_get_conversation_countsreadGet conversation counts
chatwoot_get_conversationreadGet conversation
chatwoot_list_messagesreadList messages
chatwoot_list_contactsreadList contacts
chatwoot_search_contactsreadSearch contacts
chatwoot_get_contactreadGet contact
chatwoot_list_contact_conversationsreadList contact conversations
chatwoot_list_labelsreadList labels
chatwoot_list_inboxesreadList inboxes
chatwoot_list_agentsreadList agents
chatwoot_list_teamsreadList teams
chatwoot_list_canned_responsesreadList canned responses
chatwoot_send_messagewriteSend message or private note
chatwoot_set_conversation_statuswriteSet conversation status
chatwoot_set_conversation_prioritywriteSet conversation priority
chatwoot_assign_conversationwriteAssign conversation
chatwoot_usage_statusmetaUsage status (free-tier meter)
chatwoot_request_featuremetaRequest a missing feature
chatwoot_upgrademetaUpgrade to Pro or Pro+
chatwoot_cancel_subscriptionmetaCancel the Pro subscription

read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.

Pricing

PlanPriceLimit
Free$050 tool calls / month
Pro (per user)$9/mo or $90/yr (2 months free)Unlimited*

*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].

Pro covers this server only. Subscribe with chatwoot_upgrade (it returns a Stripe Checkout link). Cancel any time with chatwoot_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running chatwoot_upgrade before then undoes the cancel. Or write to [email protected].

License

MIT — see LICENSE. Documentation only; the server is hosted.

Source: servers/chatwoot/README.md at commit 4046075

Tools

18

chatwoot_get_account

Get account

Get the configured Chatwoot account: name, locale, features and plan. Chatwoot API: GET /api/v1/accounts/{account_id}.

Takes no parameters.

chatwoot_list_conversations

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.

Parametersqpagelabelsstatusteam_idinbox_idassignee_type

chatwoot_get_conversation_counts

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.

Parametersqstatusteam_idinbox_id

chatwoot_get_conversation

Get conversation

Get one conversation with its status, priority, assignee, team, labels and contact. Chatwoot API: GET .../conversations/{conversation_id}.

Parametersconversation_idrequired

chatwoot_list_messages

List messages

List the messages of one conversation, oldest first. Chatwoot API: GET .../conversations/{conversation_id}/messages.

Parametersafterbeforeconversation_idrequired

chatwoot_list_contacts

List contacts

List resolved contacts (those with an email, phone number or identifier), 15 per page. Chatwoot API: GET .../contacts.

Parameterspagesort

chatwoot_search_contacts

Search contacts

Search resolved contacts by a text key (name, email or phone). Chatwoot API: GET .../contacts/search.

Parametersqrequiredpagesort

chatwoot_get_contact

Get contact

Get one contact with its attributes, labels and custom attributes. Chatwoot API: GET .../contacts/{id}.

Parameterscontact_idrequired

chatwoot_list_contact_conversations

List contact conversations

List all conversations of one contact. Chatwoot API: GET .../contacts/{id}/conversations.

Parameterscontact_idrequired

chatwoot_list_labels

List labels

List all labels of the account. Chatwoot API: GET .../labels.

Takes no parameters.

chatwoot_list_inboxes

List inboxes

List the inboxes (channels) of the account. Chatwoot API: GET .../inboxes.

Takes no parameters.

chatwoot_list_agents

List agents

List the agents of the account with their roles. Chatwoot API: GET .../agents.

Takes no parameters.

chatwoot_list_teams

List teams

List the teams of the account. Chatwoot API: GET .../teams.

Takes no parameters.

chatwoot_list_canned_responses

List canned responses

List the saved reply templates (canned responses) of the account. Chatwoot API: GET .../canned_responses.

Takes no parameters.

chatwoot_send_message

Send message or private note

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.

Parameterscontentrequiredprivateconversation_idrequired

chatwoot_set_conversation_status

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.

Parametersstatusrequiredsnoozed_untilconversation_idrequired

chatwoot_set_conversation_priority

Set conversation priority

Set a conversation priority: urgent, high, medium, low, or none (clears it). Chatwoot API: PATCH .../conversations/{conversation_id}.

Parameterspriorityrequiredconversation_idrequired

chatwoot_assign_conversation

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.

Parametersteam_idassignee_idconversation_idrequired

Version history

6
  1. v1.3.4LatestNov 7, 2026
  2. v1.2.3Nov 5, 2026
  3. v1.2.2Nov 5, 2026
  4. v1.2.1Nov 4, 2026
  5. v1.2.0Nov 3, 2026
  6. v1.1.1Nov 3, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Usefulapi integrations

Ably MCP by usefulapi

io.usefulapiOfficial publisher

Ably MCP by usefulapi's hosted MCP server, published by usefulapi.io; no sign-in required; Streamable HTTP; 15 tools.

Streamable HTTPWeb executable
Communication & Collaboration15 toolsNov 7, 2026

Woffu MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant look up Woffu company users, employment contracts, departments and offices.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

White Label Loyalty MCP by usefulapi

io.usefulapiOfficial publisher

Hosted MCP server for White Label Loyalty: browse rewards, read a customer's points wallet and tier progress, and buy rewards with points.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026

Weekdone MCP by usefulapi

io.usefulapiOfficial publisher

Hosted Weekdone connector that lets an assistant read weekly reports, teams, objectives and KPIs, and add report items, comments and KPI values.

Streamable HTTPWeb executable
Data & Analytics15 toolsNov 7, 2026

WebinarKit MCP by usefulapi

io.usefulapiOfficial publisher

Hosted read-only MCP server that lets an assistant list WebinarKit webinars, their dates, series, meetings and white-label sub-accounts.

Streamable HTTPWeb executable
Business & Commerce5 toolsNov 7, 2026