Chatwoot MCP by usefulapi

io.usefulapi由 usefulapi.io 發布官方發布者v1.3.4更新於 Nov 7, 2026

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

發布方自己的服務:Ably MCP by usefulapi

已驗證Streamable HTTP可網頁執行溝通與協作商業與電商

概覽

AI 產生的概覽

託管的 Chatwoot MCP,讓助理讀取客服對話與聯絡人、回覆或新增內部備註,並設定狀態、優先順序和指派。

可以做什麼
  • 讀取帳戶資訊、對話清單與數量統計、單一對話及其訊息,以及收件匣、客服人員、團隊、標籤和預設回覆。
  • 搜尋並檢視聯絡人,包括其屬性和所有對話。
  • 在對話中新增訊息,可以是內部備註,也可以是客戶看得到的回覆。
  • 設定對話狀態(開啟、已解決、待處理、暫緩)、優先順序,並指派給客服人員或團隊。
  • 查看每月工具呼叫用量、提出功能需求,以及管理付費訂閱。
適用情境
適合讓助理協助處理 Chatwoot 客服收件匣:找出未指派或開啟中的對話、整理客戶往來紀錄、草擬回覆或備註,並把對話轉給合適的客服人員或團隊,不必切換工具。
執行需求
遠端 MCP 端點,只需加入網址,不必在本機安裝。透過 OAuth 登入,首次連線時需提供 Chatwoot 存取權杖和帳戶 ID,伺服器會依使用者儲存。免費方案每月 50 次工具呼叫,另有付費方案。
安裝前請注意
寫入類工具會變更 Chatwoot 資料:把訊息的 private 設為 false 會真的送出客戶收到的回覆,狀態、優先順序和指派的變更團隊都看得到。伺服器會保存你的 Chatwoot 存取權杖,應視為敏感憑證。付費方案涉及付款連結和訂閱;取消後服務持續到已付費期間結束,當期不退費。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Chatwoot MCP by usefulapi,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/io.usefulapi%2Fchatwoot/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "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.

來源:servers/chatwoot/README.md,提交 4046075

工具

18

chatwoot_get_account

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

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.

輸入參數qpagelabelsstatusteam_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.

輸入參數qstatusteam_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}.

輸入參數conversation_id必填

chatwoot_list_messages

List messages

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

輸入參數afterbeforeconversation_id必填

chatwoot_list_contacts

List contacts

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

輸入參數pagesort

chatwoot_search_contacts

Search contacts

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

輸入參數q必填pagesort

chatwoot_get_contact

Get contact

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

輸入參數contact_id必填

chatwoot_list_contact_conversations

List contact conversations

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

輸入參數contact_id必填

chatwoot_list_labels

List labels

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

無需輸入參數。

chatwoot_list_inboxes

List inboxes

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

無需輸入參數。

chatwoot_list_agents

List agents

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

無需輸入參數。

chatwoot_list_teams

List teams

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

無需輸入參數。

chatwoot_list_canned_responses

List canned responses

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

無需輸入參數。

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.

輸入參數content必填privateconversation_id必填

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.

輸入參數status必填snoozed_untilconversation_id必填

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

輸入參數priority必填conversation_id必填

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.

輸入參數team_idassignee_idconversation_id必填

版本歷史

6
  1. v1.3.4最新Nov 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

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

其他 Usefulapi 整合