@fazer-ai/mcp-chatwoot

A Model Context Protocol (MCP) server that exposes the full Chatwoot API — including fazer.ai exclusive features — as 129 tools for use with AI assistants like Claude, VS Code Copilot, and others.

Features

• 129 tools covering all Chatwoot API endpoints
• Account, Agents, Contacts, Conversations, Messages, Inboxes, Teams, and more
• Reports (v1 & v2), Help Center, Automation Rules, Custom Attributes, Custom Filters
• [fazer.ai] exclusive: Kanban Boards, Kanban Steps, Kanban Tasks, Kanban Audit Events, Kanban Preferences, Scheduled Messages
• Proper MCP tool annotations (readOnlyHint, destructiveHint, idempotentHint)
• Multi-account support (account_id is a per-tool argument)
• stdio transport (compatible with Claude Desktop, VS Code, and any MCP client)

Requirements

• Bun v1.0+
• A Chatwoot instance with API access

Installation

bun install

Environment Variables

Usage

Development

bun run dev

Production

bun run start

Claude Desktop Configuration

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "chatwoot": {
      "command": "bun",
      "args": ["run", "/path/to/mcp-chatwoot/src/index.ts"],
      "env": {
        "CHATWOOT_BASE_URL": "https://your-chatwoot-instance.com",
        "CHATWOOT_API_TOKEN": "your-api-token"
      }
    }
  }
}

VS Code Configuration

Add to your .vscode/mcp.json:

{
  "servers": {
    "chatwoot": {
      "command": "bun",
      "args": ["run", "${workspaceFolder}/src/index.ts"],
      "env": {
        "CHATWOOT_BASE_URL": "https://your-chatwoot-instance.com",
        "CHATWOOT_API_TOKEN": "your-api-token"
      }
    }
  }
}

Available Tools (129)

Account (2)

account_get, account_update

Agent Bots (5)

agent_bots_list, agent_bots_create, agent_bots_get, agent_bots_update, agent_bots_delete

Agents (4)

agents_list, agents_create, agents_update, agents_delete

Audit Logs (1)

audit_logs_list

Automation Rules (5)

automation_rules_list, automation_rules_create, automation_rules_get, automation_rules_update, automation_rules_delete