@indica-facil/mcp-chatwoot
Provides tools for managing a Chatwoot instance, including accounts, agents, contacts, conversations, messages, inboxes, teams, reports, help center, automation rules, custom attributes, filters, and exclusive kanban boards, steps, tasks, audit events, preferences, and scheduled messages via the Chatwoot API.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@indica-facil/mcp-chatwootlist open conversations from yesterday"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@indicafacil/mcp-chatwoot
A Model Context Protocol (MCP) server that exposes the full Chatwoot API — including indicafacil.ai exclusive features — as 147 tools for use with AI assistants like Claude, VS Code Copilot, and others.
Features
147 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
[indicafacil.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_idis a per-tool argument)stdio transport (compatible with Claude Desktop, VS Code, and any MCP client)
Related MCP server: Plain.com MCP Server
Requirements
Bun v1.0+
A Chatwoot instance with API access
Installation
bun installEnvironment Variables
Variable | Required | Description |
| Yes | Your Chatwoot instance URL (e.g. |
| Yes | API access token (found in Chatwoot → Profile → Access Token) |
Usage
Development
bun run devProduction
bun run startClaude 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 (147)
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
Canned Responses (4)
canned_responses_list, canned_responses_create, canned_responses_update, canned_responses_delete
Contacts (11)
contacts_list, contacts_create, contacts_get, contacts_update, contacts_delete, contacts_conversations, contacts_search, contacts_filter, contacts_create_contact_inbox, contacts_contactable_inboxes, contacts_merge
Contact Labels (2)
contact_labels_list, contact_labels_set
Conversations (12)
conversations_meta, conversations_list, conversations_create, conversations_filter, conversations_get, conversations_update, conversations_toggle_status, conversations_toggle_priority, conversations_set_custom_attributes, conversations_get_labels, conversations_set_labels, conversations_reporting_events
Conversation Assignments (1)
conversation_assignments_assign
Messages (3)
messages_list, messages_create, messages_delete
Custom Attributes (5)
custom_attributes_list, custom_attributes_create, custom_attributes_get, custom_attributes_update, custom_attributes_delete
Custom Filters (5)
custom_filters_list, custom_filters_create, custom_filters_get, custom_filters_update, custom_filters_delete
Help Center (5)
help_center_portals_list, help_center_portals_create, help_center_portals_update, help_center_categories_create, help_center_articles_create
Inboxes (11)
inboxes_list, inboxes_get, inboxes_create, inboxes_update, inboxes_get_agent_bot, inboxes_set_agent_bot, inbox_members_list, inbox_members_create, inbox_members_update, inbox_members_delete
Integrations (4)
integrations_list_apps, integrations_create_hook, integrations_update_hook, integrations_delete_hook
Profile (1)
profile_get
Reports (9)
reports_account_overview, reports_account_summary, reports_agent_summary, reports_conversation_metrics, reports_v2_overview, reports_v2_agents, reports_v2_inboxes, reports_v2_teams, reports_v2_labels
Teams (9)
teams_list, teams_create, teams_get, teams_update, teams_delete, team_members_list, team_members_add, team_members_update, team_members_delete
Webhooks (4)
webhooks_list, webhooks_create, webhooks_update, webhooks_delete
Kanban Boards (9) — [indicafacil.ai]
kanban_boards_list, kanban_boards_create, kanban_boards_get, kanban_boards_update, kanban_boards_delete, kanban_boards_update_agents, kanban_boards_update_inboxes, kanban_boards_toggle_favorite, kanban_boards_conversations
Kanban Steps (6) — [indicafacil.ai]
kanban_steps_list, kanban_steps_create, kanban_steps_get, kanban_steps_update, kanban_steps_delete, kanban_steps_reorder
Kanban Tasks (6) — [indicafacil.ai]
kanban_tasks_list, kanban_tasks_create, kanban_tasks_get, kanban_tasks_update, kanban_tasks_delete, kanban_tasks_move
Kanban Task Products (4) — [indicafacil.ai]
kanban_task_products_list, kanban_task_products_create, kanban_task_products_update, kanban_task_products_delete
Kanban Task Comments (4) — [indicafacil.ai]
kanban_task_comments_list, kanban_task_comments_create, kanban_task_comments_update, kanban_task_comments_delete
Kanban Products (5) — [indicafacil.ai]
kanban_products_list, kanban_products_get, kanban_products_create, kanban_products_update, kanban_products_delete
Kanban Reports (7) — [indicafacil.ai]
kanban_reports_summary, kanban_reports_funnel, kanban_reports_stage_durations, kanban_reports_agent_performance, kanban_reports_cfd, kanban_reports_aging, kanban_reports_timeseries
Kanban Audit Events (2) — [indicafacil.ai]
kanban_audit_events_list, kanban_audit_events_get
Scheduled Messages (4) — [indicafacil.ai]
scheduled_messages_list, scheduled_messages_create, scheduled_messages_update, scheduled_messages_delete
Development
# Run tests
bun test
# Lint & format
bun run lint
bun run format
# Type check
bun run build-check
# Full check (lint + type-check + tests)
bun run checkLicense
MIT
This server cannot be deployed
Maintenance
Related MCP Connectors
Manage AI assistants, history, calls, campaigns, contacts, knowledge, messaging, and automations.
Messaging tools for AI agents: send messages, manage chats, groups and channels.
Carbon Voice MCP serves as a bridge that connects AI assistants like ChatGPT, Claude, and Cursor to a user's Carbon Voice account, turning voice messages and conversations into a private, on-demand knowledge base. It provides 28 specialized tools for comprehensive voice messaging management, including creating and sending messages, accessing conversation history with instant transcription, running AI actions (summarization, TLDR generation, meeting notes), and managing workspace collaboration through folders, contacts, and team communications.
Connect AI tools to Weav customer service. Search conversations, reply, and manage knowledge.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with Cisco Webex messaging through 52 comprehensive tools covering messages, rooms, teams, people management, webhooks, and enterprise features. Supports both personal and enterprise Webex environments with complete API coverage for messaging operations.4MIT
- AlicenseNot gradedqualityCmaintenanceProvides comprehensive access to the Plain.com API with over 70 tools for managing support threads, customers, and help centers. It enables users to handle communications, automate support workflows, and manage documentation directly through natural language.14 npm4MIT
- AlicenseBqualityDmaintenanceEnables AI assistants to manage WhatsApp sessions, send multi-format messages, control group participants, and configure webhooks by wrapping the OpenWA REST API with 44 tools.442MIT
- AlicenseNot gradedqualityCmaintenanceEnables interaction with Intercom's customer communications platform via the Intercom REST API, providing 102 tools for managing admins, articles, companies, contacts, conversations, and more.2MIT