Skip to main content
Glama
minholi

chatwoot-mcp

by minholi
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CHATWOOT_URLYesThe URL of your Chatwoot instance (e.g., https://your-instance.chatwoot.com)
MCP_HOST_PORTNoPort to expose the HTTP server on when using Docker (optional)8000
CHATWOOT_API_TOKENYesYour Chatwoot API access token (found under Profile Settings → Access Token)
CHATWOOT_ACCOUNT_IDYesYour Chatwoot account ID

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
chatwoot_get_summaryA

Returns the account summary: conversations, response times, resolution rate, and CSAT.

Args:
    period: Analysis period (today, yesterday, 7d, 15d, 30d, 90d).
    output_format: Output format — markdown (default) or json.
chatwoot_get_bot_summaryB

Returns overall bot performance: handoffs, autonomous resolution rate, and average response time.

Args:
    period: Analysis period.
    output_format: Output format.
chatwoot_get_conversation_trafficA

Returns a conversation traffic heat map (hour × day of week).

Useful for identifying peak hours and staffing teams appropriately.

Args:
    period: Analysis period.
    output_format: Output format.
chatwoot_list_agentsA

Lists all agents in the account with ID, email, and availability status.

Args:
    output_format: Output format.
chatwoot_get_agent_performanceA

Returns performance metrics for a specific agent.

Includes: open and resolved conversations, average first response time,
average resolution time, and CSAT.

Args:
    agent_id: Agent ID (use chatwoot_list_agents to get IDs).
    period: Analysis period.
    output_format: Output format.
chatwoot_list_conversationsB

Lists conversations with filters by status, assignee, inbox, team, and label.

Args:
    status: Conversation status (open, resolved, pending, snoozed, all).
    assignee_type: Filter by assignment type (me, assigned, unassigned, all).
    inbox_id: Inbox ID to filter by (use chatwoot_list_inboxes).
    team_id: Team ID to filter by (use chatwoot_list_teams).
    label: Label to filter by (use chatwoot_list_labels to see available labels).
    page: Results page (25 per page).
    output_format: Output format.
chatwoot_search_conversationsA

Searches conversations and messages by text.

Args:
    query: Text to search across conversations and messages.
    page: Results page.
    output_format: Output format.
chatwoot_get_conversationC

Returns the full details of a specific conversation.

Args:
    conversation_id: Conversation ID.
    output_format: Output format.
chatwoot_get_conversation_messagesC

Returns the complete message history of a conversation.

Args:
    conversation_id: Conversation ID.
    output_format: Output format.
chatwoot_list_labelsA

Lists all labels in the account with ID, color, and description.

Labels are used to tag and categorize conversations.

Args:
    output_format: Output format.
chatwoot_get_label_performanceA

Returns performance metrics for a specific label.

Allows quantitative analysis of conversations by category/tag.

Args:
    label_id: Label ID (use chatwoot_list_labels to get IDs).
    period: Analysis period.
    output_format: Output format.
chatwoot_list_inboxesB

Lists all inboxes (channels) in the account: WhatsApp, email, widget, etc.

Args:
    output_format: Output format.
chatwoot_get_inbox_performanceB

Returns performance metrics for a specific inbox.

Args:
    inbox_id: Inbox ID (use chatwoot_list_inboxes to get IDs).
    period: Analysis period.
    output_format: Output format.
chatwoot_list_teamsC

Lists all teams in the account.

Args:
    output_format: Output format.
chatwoot_get_team_performanceB

Returns performance metrics for a specific team.

Args:
    team_id: Team ID (use chatwoot_list_teams to get IDs).
    period: Analysis period.
    output_format: Output format.
chatwoot_list_captain_assistantsA

Lists all Captain (AI) assistants configured in the account.

Args:
    output_format: Output format.
chatwoot_get_captain_metricsB

Returns performance metrics for a Captain (AI) assistant.

Includes autonomous resolution rate, handoffs to humans, and FAQ usage.

Args:
    assistant_id: Assistant ID (use chatwoot_list_captain_assistants).
    period: Analysis period.
    output_format: Output format.
chatwoot_get_csat_responsesA

Returns customer satisfaction survey (CSAT) responses.

Enables qualitative analysis of support quality based on customer feedback.

Args:
    period: Analysis period.
    rating: Filter by score (1 to 5). None = all scores.
    inbox_id: Filter by a specific inbox.
    team_id: Filter by a specific team.
    page: Results page.
    output_format: Output format.
chatwoot_get_csat_metricsB

Returns the aggregated CSAT summary: total responses, breakdown by score, and response rate.

Args:
    period: Analysis period.
    inbox_id: Filter by a specific inbox.
    team_id: Filter by a specific team.
    output_format: Output format.
chatwoot_get_live_metricsB

Returns real-time conversation counts: open, unattended, unassigned, and pending.

Args:
    output_format: Output format.
chatwoot_get_live_grouped_metricsB

Returns real-time conversations grouped by team or agent.

Args:
    group_by: Group by team (team_id) or agent (assignee_id).
    team_id: Filter by a specific team (optional).
    output_format: Output format.
chatwoot_search_contactsA

Searches contacts by name, email, phone, or identifier.

Args:
    query: Text to search (name, email, phone, or identifier).
    page: Results page.
    output_format: Output format.
chatwoot_get_contactA

Returns the full details of a specific contact.

Args:
    contact_id: Contact ID (use chatwoot_search_contacts to get IDs).
    output_format: Output format.
chatwoot_get_contact_conversationsA

Returns the full conversation history of a specific contact.

Args:
    contact_id: Contact ID (use chatwoot_search_contacts to get IDs).
    output_format: Output format.
chatwoot_get_captain_faq_statsB

Returns usage and effectiveness statistics for a Captain assistant's knowledge base (FAQ).

Args:
    assistant_id: Assistant ID (use chatwoot_list_captain_assistants).
    range: Analysis period in days or month (7, 30, 90, this_month, last_month).
    output_format: Output format.
chatwoot_get_captain_overviewA

Returns overview metrics for a Captain assistant with period-to-period comparison.

Args:
    assistant_id: Assistant ID (use chatwoot_list_captain_assistants).
    range: Analysis period in days or month (7, 30, 90, this_month, last_month).
    output_format: Output format.
chatwoot_get_captain_resolution_flowA

Returns the conversation resolution funnel for a Captain assistant (steps to resolution).

Args:
    assistant_id: Assistant ID (use chatwoot_list_captain_assistants).
    range: Analysis period in days or month (7, 30, 90, this_month, last_month).
    output_format: Output format.
chatwoot_get_captain_resolution_trendA

Returns the resolution rate trend for a Captain assistant over time.

Args:
    assistant_id: Assistant ID (use chatwoot_list_captain_assistants).
    range: Analysis period in days or month (7, 30, 90, this_month, last_month).
    output_format: Output format.
chatwoot_get_inbox_label_matrixA

Returns the conversation distribution between inboxes and labels (inbox × label matrix).

Useful for understanding which channels generate which types of conversations.

Args:
    period: Analysis period.
    inbox_ids: Filter by specific inboxes (list of IDs; use chatwoot_list_inboxes).
    label_ids: Filter by specific labels (list of IDs; use chatwoot_list_labels).
    output_format: Output format.
chatwoot_get_first_response_distributionB

Returns a histogram of first response time distribution.

Allows identifying which time range most first responses fall into.

Args:
    period: Analysis period.
    output_format: Output format.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

B3.4/5.0

Scored across 30 tools

Disambiguation5/5

Each tool has a clearly distinct purpose: list vs. get vs. search, and per-entity performance metrics are separated by resource (agent, inbox, team, label, captain). Even the Captain analytics tools (FAQ stats, overview, resolution flow, resolution trend) are differentiated by their focus, reducing selection ambiguity.

Naming Consistency5/5

All tools follow a strict chatwoot_<verb>_<noun> pattern with consistent verbs (get, list, search). The naming is uniform across all 30 tools, making the API predictable and easy to navigate.

Tool Count4/5

At 30 tools, the server is on the heavier side, but the breadth of Chatwoot's feature set (agents, inboxes, teams, labels, contacts, conversations, CSAT, Captain AI, live metrics, analytics) justifies the count. Each tool covers a distinct aspect, so the number feels appropriate for a comprehensive analytics-focused MCP.

Completeness4/5

The server is strong for read-only analytics and reporting, covering the main entities and metrics. Minor gaps exist: no single-entity detail tools beyond list (e.g., get_inbox, get_team), and no write operations, but that aligns with its apparent reporting purpose. The core lifecycle of querying and analyzing data is well covered.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources