Skip to content
MCP server

ChatDesq

MCP server giving AI assistants access to a ChatDesq WhatsApp Business inbox, contacts

Runs locally
Install
Pricing
Open source
Platforms
CLI, API, Web
Runs
Locally
Version
0.1.0
Listing updated
today

Similar MCP servers

About ChatDesq

ChatDesq is an open-source MCP server for communication. It runs locally on your machine and is started by your AI client.

The README describes this server as a bridge between AI assistants such as Claude Desktop and Cursor and a ChatDesq workspace. Once configured with an API key from the ChatDesq settings, an assistant can look up contacts, read inbox conversations, check template approval status and delivery status, and manage CRM pipelines and deals.

The tool list separates read-only lookups from write actions. Writes are limited to sending a single text or approved template message, creating or updating contacts, tagging contacts and creating deals. The README states that bulk broadcasts, drip enrolment, deletes and API key rotation are deliberately not exposed through this server.

The server is aimed at teams who already run WhatsApp customer messaging on ChatDesq and want an assistant to help with inbox triage, template checks or CRM updates. It requires a ChatDesq account and a WhatsApp Business setup on that platform.

Install

Run in a terminal

claude mcp add mcp-server --env CHATDESQ_API_KEY='<CHATDESQ_API_KEY>' -- npx -y @chatdesq/mcp-server

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@chatdesq/mcp-server"
      ],
      "env": {
        "CHATDESQ_API_KEY": "<CHATDESQ_API_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@chatdesq/mcp-server"
      ],
      "env": {
        "CHATDESQ_API_KEY": "<CHATDESQ_API_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@chatdesq/mcp-server"
      ],
      "env": {
        "CHATDESQ_API_KEY": "<CHATDESQ_API_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@chatdesq/mcp-server"
      ],
      "env": {
        "CHATDESQ_API_KEY": "<CHATDESQ_API_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@chatdesq/mcp-server"
      ],
      "env": {
        "CHATDESQ_API_KEY": "<CHATDESQ_API_KEY>"
      }
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Configuration

  • CHATDESQ_API_KEYAPI key from ChatDesq > Settings > API keysRequired
  • CHATDESQ_API_BASEOptional API base URL (default https://api.chatdesq.com/v1)

Tools this server provides (17)

Taken from the project documentation; the running server may differ.

list_whatsapp_numbers
Connected WhatsApp Business numbers
list_contacts
Search contacts by name, phone, email, tag or segment
get_contact
Search contacts by name, phone, email, tag or segment
list_tags
Contact tags
list_templates
Message templates with Meta approval status and category
list_conversations
Inbox conversations and their messages
get_conversation_messages
Inbox conversations and their messages
get_message_status
Delivery status of a sent message
list_broadcasts
Broadcast campaigns and their counts
list_pipelines
CRM pipelines, stages and deals
list_deals
CRM pipelines, stages and deals
send_text_message
One free-form text, inside the 24-hour service window
send_template_message
One approved template to one opted-in number
create_contact
Contact records and tags
update_contact
Contact records and tags
tag_contact
Contact records and tags
create_deal
A CRM deal for a contact

What it does

Read-only inbox lookups
Assistants can list conversations, read messages and check delivery status without changing data.
Contact and tag management
Search contacts, create or update records and apply tags through named tools.
Template status checks
List message templates with their Meta approval status and category.
CRM deal tools
View pipelines and deals, and create a deal for a contact.
Limited write scope
Bulk broadcasts, drip enrolment, deletes and key rotation are excluded from the server by design.

Good for

  • Triage open WhatsApp conversations and draft replies for review before sending
  • Check whether message templates are approved before a campaign
  • Look up a customer's contact record and add tags or deals from an assistant
  • Confirm whether a specific sent message was delivered

Pricing

Open source

Server is MIT licensed; the ChatDesq platform is a prepaid per-message service with a ₹0 platform fee.

Prices change. Check chatdesq.com before you buy.

ChatDesq FAQ

How is the server configured?

Set CHATDESQ_API_KEY from ChatDesq Settings > API keys, and optionally CHATDESQ_API_BASE. The README shows examples for Claude Desktop, Cursor and Claude Code.

Can the server send bulk messages?

No. The README says bulk broadcasts are left out on purpose, and single messages are limited to one free-form text or one approved template.

What is the license?

The README says the project is MIT licensed.

Which tools only read data?

The README marks list_whatsapp_numbers, list_contacts, get_contact, list_tags, list_templates, list_conversations, get_conversation_messages, get_message_status, list_broadcasts, list_pipelines and list_deals as not changing data.

Is ChatDesq free?

Yes. ChatDesq is open source, so you can use and self-host it for free.

How do I add ChatDesq to Claude Code?

Run this command in your terminal: claude mcp add mcp-server --env CHATDESQ_API_KEY='<CHATDESQ_API_KEY>' -- npx -y @chatdesq/mcp-server

What are the best alternatives to ChatDesq?

The closest alternatives to ChatDesq are Automate AI, Spun WhatsApp MCP, Cosend, WhatsApp Business API by Wassenger and MajlisDesk: WhatsApp shared inbox.

Where this comes from

  • Description: written from the project's README, the project's website and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers