# Chatwoot MCP by usefulapi

> Chatwoot MCP by usefulapi is an MCP server. Read conversations and contacts; add replies or notes, set status and assign in Chatwoot. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/chatwoot/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/chatwoot
- **MCP Registry name:** io.usefulapi/chatwoot
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://chatwoot.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "chatwoot": {
      "url": "https://chatwoot.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

---
Source: https://ai-powered.com/mcp/chatwoot-mcp-by-usefulapi
