# ChatDesq

> ChatDesq is an open-source MCP server for communication. MCP server giving AI assistants access to a ChatDesq WhatsApp Business inbox, contacts. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Web
- **Website:** https://chatdesq.com
- **Repository:** https://github.com/chatdesq/mcp-server
- **MCP Registry name:** io.github.chatdesq/mcp-server
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-19

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [Automate AI](https://ai-powered.com/mcp/automate-ai): Automate AI is a paid MCP server for communication.
- [Spun WhatsApp MCP](https://ai-powered.com/mcp/spun-whatsapp-mcp): Spun WhatsApp MCP is a freemium MCP server for communication.
- [Cosend](https://ai-powered.com/mcp/cosend): Cosend is a freemium MCP server for communication.
- [WhatsApp Business API by Wassenger](https://ai-powered.com/mcp/whatsapp-business-api-by-wassenger): WhatsApp Business API by Wassenger is an MCP server for communication.
- [MajlisDesk: WhatsApp shared inbox](https://ai-powered.com/mcp/majlisdesk-whatsapp-shared-inbox): MajlisDesk: WhatsApp shared inbox is an MCP server for communication.
- [Sonar for WhatsApp Business](https://ai-powered.com/mcp/sonar-for-whatsapp-business): Sonar for WhatsApp Business is a freemium MCP server for communication.
- [WhatSync](https://ai-powered.com/mcp/whatsync): WhatSync is a paid MCP server for communication.
- [ChatPush](https://ai-powered.com/mcp/chatpush): ChatPush is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/chatdesq
