Which integrations are available for this server?

Provides read-only access to Chatwoot analytics and data, enabling tools to retrieve conversations, agent and inbox performance, team metrics, labels, CSAT responses, Captain AI insights, real-time metrics, and contact details.

How do I use chatwoot-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@chatwoot-mcp Can you give me a summary of our support performance over the past week?" 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.

chatwoot-mcp

by minholi

Overview Schema Related Servers Score Discussions

Python

Remote

chatwoot-mcp

An MCP (Model Context Protocol) server that exposes Chatwoot analytics data to AI assistants. All tools are read-only.

Features

32 MCP tools covering conversations, agents, inboxes, teams, labels, CSAT, Captain AI, real-time metrics, and contacts
Two transport modes: stdio for Claude Desktop, HTTP for claude.ai remote connector
Multi-tenant HTTP mode: each user provides their own Chatwoot credentials per request
Dual output format: markdown (human-readable) or json for all tools
Period shortcuts: built-in ranges like hoje, 7d, 30d, 90d for all time-series queries

Related MCP server: Clamp Analytics MCP Server

Requirements

Python 3.11+
uv package manager
A Chatwoot account with API access

Installation

git clone https://github.com/minholi/chatwoot-mcp.git
cd chatwoot-mcp
uv sync

Configuration

Copy .env.example to .env and fill in your credentials:

cp .env.example .env

CHATWOOT_URL=https://your-instance.chatwoot.com
CHATWOOT_ACCOUNT_ID=1
CHATWOOT_API_TOKEN=your_api_token_here

Your API token can be found in Chatwoot under Profile Settings → Access Token.

Usage

Stdio mode (Claude Desktop)

Run the server directly — credentials come from the .env file:

uv run python main.py

To integrate with Claude Desktop, add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "chatwoot": {
      "command": "uv",
      "args": ["run", "python", "main.py"],
      "cwd": "/path/to/chatwoot-mcp",
      "env": {
        "CHATWOOT_URL": "https://your-instance.chatwoot.com",
        "CHATWOOT_ACCOUNT_ID": "1",
        "CHATWOOT_API_TOKEN": "your_api_token_here"
      }
    }
  }
}

HTTP mode (claude.ai remote connector)

Start the server in HTTP mode:

uv run python main.py --transport http --port 8000

Each request must include a composite key in the Authorization or X-API-Key header:

Authorization: Bearer https://your-instance.chatwoot.com|account_id|api_token

This allows multiple users to connect with their own credentials without server-side configuration.

Available endpoints:

Endpoint	Description
`GET /`	Service info
`GET /health`	Health check
`POST /mcp`	MCP protocol (stateless)

Docker

docker compose up -d

The compose file reads from .env and runs in HTTP mode on http://127.0.0.1:8000 by default. Set MCP_HOST_PORT in .env to change the exposed port.

Available tools

Overview

Tool	Description
`chatwoot_get_summary`	Account summary: conversation counts, response times, resolution rate, CSAT
`chatwoot_get_bot_summary`	Bot performance: handoffs, autonomous resolution rate, average response time
`chatwoot_get_conversation_traffic`	Heat map of conversation volume by hour and day of week

Agents

Tool	Description
`chatwoot_list_agents`	List all agents with ID, email, and availability status
`chatwoot_get_agent_performance`	Per-agent metrics: open/resolved conversations, response time, CSAT

Conversations

Tool	Description
`chatwoot_list_conversations`	List conversations with filters (status, assignee, inbox, team, label)
`chatwoot_search_conversations`	Full-text search across conversations and messages
`chatwoot_get_conversation`	Full details of a specific conversation
`chatwoot_get_conversation_messages`	Complete message history of a conversation

Labels

Tool	Description
`chatwoot_list_labels`	List all labels with ID, color, and description
`chatwoot_get_label_performance`	Performance metrics for a specific label

Inboxes

Tool	Description
`chatwoot_list_inboxes`	List all inboxes (WhatsApp, email, widget, etc.)
`chatwoot_get_inbox_performance`	Performance metrics for a specific inbox

Teams

Tool	Description
`chatwoot_list_teams`	List all teams
`chatwoot_get_team_performance`	Performance metrics for a specific team

Captain AI

Tool	Description
`chatwoot_list_captain_assistants`	List AI assistants configured in the account
`chatwoot_get_captain_metrics`	AI assistant performance metrics
`chatwoot_get_captain_faq_stats`	FAQ usage and effectiveness statistics
`chatwoot_get_captain_overview`	Period-to-period comparison overview
`chatwoot_get_captain_resolution_flow`	Funnel of resolution steps
`chatwoot_get_captain_resolution_trend`	Resolution rate trend over time

CSAT

Tool	Description
`chatwoot_get_csat_responses`	Survey responses with filters (period, rating, inbox, team)
`chatwoot_get_csat_metrics`	Aggregated CSAT summary with breakdown by rating

Real-time

Tool	Description
`chatwoot_get_live_metrics`	Real-time counts: open, unattended, unassigned, pending
`chatwoot_get_live_grouped_metrics`	Real-time conversations grouped by team or agent

Contacts

Tool	Description
`chatwoot_search_contacts`	Search contacts by name, email, phone, or identifier
`chatwoot_get_contact`	Full contact details
`chatwoot_get_contact_conversations`	Conversation history of a contact

Advanced reports

Tool	Description
`chatwoot_get_inbox_label_matrix`	Cross-distribution of conversations between inboxes and labels
`chatwoot_get_first_response_distribution`	Histogram of first-response-time distribution

Development

# Lint and format
uv run ruff check src/ main.py
uv run ruff format src/ main.py

# Run tests
uv run pytest

License

MIT — see LICENSE.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

No tool schema history has been recorded yet.

This server cannot be installed

RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

Maintenance

ActivityMaintained

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Betterlytics
io.betterlytics
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
Monitoring Observability
1170
AgentioOAuth
com.agentio
Ask about your Agentio campaigns, Creator deals, and performance on YouTube and Meta. Read-only.
Marketing Social Media
1
Hitsteps Analytics and OperationsOAuth
com.hitsteps
AI access to Hitsteps analytics, live visitors, uptime, goals, alerts, and chats.
Monitoring Observability
2
RulebaseOAuth
co.rulebase
CX ops: read conversations, calls and QA evaluations from Zendesk, Freshdesk, Five9 and more.
Customer Support Communication Search
1

Related MCP Servers

Lumenore Analytics MCP Serverofficial
Search Data Platforms Research & Data
Lumenore-Platform
A
license
Not graded
quality
D
maintenance
Provides AI assistants with access to Lumenore's analytics capabilities, enabling natural language queries for data insights, advanced analytics (trends, predictions, correlations, outliers), and real-time data processing with zero persistent storage.
Updated 7 months ago (2026-02-02 06:10 UTC)
MIT
Clamp Analytics MCP Serverofficial
Monitoring Search
clamp-sh
A
license
A
quality
A
maintenance
Provides AI assistants with read access to Clamp analytics data including pageviews, visitors, referrers, and custom events. Enables traffic analysis, conversion funnel evaluation, and metric alerts through natural language queries.
Updated 2 months ago (2026-07-07 18:51 UTC)
33
32
2
MIT
Secureframe MCP Serverofficial
Legal & Compliance Security
secureframe
A
license
Not graded
quality
F
maintenance
Provides AI assistants with read-only access to Secureframe's compliance data, enabling querying of security controls, tests, users, vendors, and more across frameworks like SOC 2 and ISO 27001.
Updated 2 months ago (2026-07-17 01:42 UTC)
8
MIT
infera-mcp-server
Finance CRM
rdndelgado
F
license
Not graded
quality
B
maintenance
Enables AI assistants to query internal business data for insights into customers, revenue, subscriptions, sales, and churn through controlled, read-only MCP tools.
Updated 19 days ago (2026-08-19 16:53 UTC)
-

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/minholi/chatwoot-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

chatwoot-mcp

Features

Requirements

Installation

Configuration

Usage

Stdio mode (Claude Desktop)

HTTP mode (claude.ai remote connector)

Docker

Available tools

Overview

Agents

Conversations

Labels

Inboxes

Teams

Captain AI

CSAT

Real-time

Contacts

Advanced reports

Development

License

Tool Schema Changelog

Maintenance

Resources

Looking for Admin?

Related MCP Connectors

Related MCP Servers

Lumenore Analytics MCP Serverofficial

Clamp Analytics MCP Serverofficial

Secureframe MCP Serverofficial

infera-mcp-server

Latest Blog Posts

MCP directory API