MCPgee
MCPgee
MCPgeeMCPgee

Chatwoot

v1.0.0•Communication•stable

MCP server for Chatwoot - Integrate Chatwoot customer support with Claude

chatwootmcpai-integration
Share:
8
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Chatwoot?

Chatwoot is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for chatwoot - integrate chatwoot customer support with claude

MCP server for Chatwoot - Integrate Chatwoot customer support with Claude

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP server for Chatwoot - Integrate Chatwoot customer suppor

Use Cases

Manage Chatwoot customer support conversations through Claude.
Automate customer communication workflows.
hugoblanc

Maintainer

LicenseMIT
Languagetypescript
Versionv1.0.0
UpdatedMay 19, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx chatwoot

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Chatwoot

Chatwoot MCP Server connects Claude to your Chatwoot customer support instance, enabling you to list conversations, read messages, send replies, and create internal notes without leaving your AI assistant. It authenticates via a personal access token or email/password credentials and supports any self-hosted or cloud Chatwoot deployment.

Prerequisites

  • Node.js 18 or higher installed
  • A running Chatwoot instance (self-hosted or cloud)
  • Chatwoot API token from Profile Settings → Access Token
  • Claude Desktop or Claude Code installed
1

Obtain your Chatwoot API token

Log in to your Chatwoot instance, click your avatar in the bottom-left corner, go to Profile Settings, and copy the Access Token shown there. This token will be used to authenticate all MCP requests.

2

Install the MCP server package

The server is published as an npm package. Install it globally or use npx to run it on demand without a permanent install.

npm install -g chatwoot-mcp-server
3

Add the server to Claude Desktop configuration

Open your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS) and add the chatwoot entry under mcpServers, substituting your real instance URL and token.

{
  "mcpServers": {
    "chatwoot": {
      "command": "npx",
      "args": ["chatwoot-mcp-server"],
      "env": {
        "CHATWOOT_BASE_URL": "https://your-chatwoot-instance.com",
        "CHATWOOT_API_TOKEN": "your_access_token_here"
      }
    }
  }
}
4

Add via Claude Code CLI (alternative)

If you use Claude Code in the terminal, register the server with the mcp add command so it is automatically loaded in every session.

claude mcp add chatwoot \
  -e CHATWOOT_BASE_URL="https://your-chatwoot-instance.com" \
  -e CHATWOOT_API_TOKEN="your_access_token_here" \
  -- npx chatwoot-mcp-server
5

Restart Claude and verify the connection

Restart Claude Desktop (or start a new Claude Code session). Ask Claude to list your open conversations. A successful response with real conversation data confirms the server is connected.

Chatwoot Examples

Client configuration

Complete claude_desktop_config.json entry for Chatwoot MCP using a personal access token.

{
  "mcpServers": {
    "chatwoot": {
      "command": "npx",
      "args": ["chatwoot-mcp-server"],
      "env": {
        "CHATWOOT_BASE_URL": "https://app.chatwoot.com",
        "CHATWOOT_API_TOKEN": "abc123yourtokenhere"
      }
    }
  }
}

Prompts to try

Example natural-language prompts to use with the Chatwoot MCP server once connected.

- "Show all open conversations in my Chatwoot inbox"
- "What are the details of conversation #142?"
- "List all unresolved conversations assigned to me"
- "Send a reply to conversation #142 saying: Thank you for your patience, we are looking into this"
- "Create an internal note on conversation #99 summarizing the issue"

Troubleshooting Chatwoot

Claude returns a 401 Unauthorized error when listing conversations

Double-check that CHATWOOT_API_TOKEN is set to a valid user access token (not an agent token). Regenerate it from Profile Settings → Access Token if needed.

The server starts but cannot reach the Chatwoot instance

Verify CHATWOOT_BASE_URL includes the protocol (https://) and no trailing slash. If your instance uses a custom port, include it, e.g. https://support.example.com:3000.

npx chatwoot-mcp-server command not found after install

Ensure the global npm bin directory is in your PATH. Run npm bin -g to find the path and add it to your shell profile. Alternatively, use the full path returned by which chatwoot-mcp-server.

Frequently Asked Questions about Chatwoot

What is Chatwoot?

Chatwoot is a Model Context Protocol (MCP) server that mcp server for chatwoot - integrate chatwoot customer support with claude It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Chatwoot?

Follow the installation instructions on the Chatwoot GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Chatwoot?

Chatwoot works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Chatwoot free to use?

Yes, Chatwoot is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Chatwoot Alternatives — Similar Communication Servers

Looking for alternatives to Chatwoot? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.

Slack

★ 86.1k

Enables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl

LibreChat

★ 37.3k

Enhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA

Note Gen

★ 11.9k

A cross-platform Markdown AI note-taking software.

DeepChat

★ 5.8k

🐬DeepChat - A smart assistant that connects powerful AI to your personal world

WhatsApp MCP

★ 5.7k

Connects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without

Apple

★ 3.1k

Enables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.

Browse More Communication MCP Servers

Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

CommunicationBrowse All Servers

Quick Config Preview

{ "mcpServers": { "chatwoot": { "command": "npx", "args": ["-y", "chatwoot"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Chatwoot?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides