Repository avatar
AI Tools
v0.1.0
active

mcp-server

io.github.chatdesq/mcp-server

WhatsApp Business API for AI assistants: contacts, templates, inbox, CRM deals, single messages.

Documentation

ChatDesq MCP Server

Connect Claude, Cursor and other AI assistants to your ChatDesq workspace. ChatDesq is a WhatsApp Business API platform for Indian D2C brands, with a ₹0 platform fee: you pay only per message.

With this server, an assistant can look up contacts, read inbox conversations, check template approval and message delivery status, manage CRM deals, and send single WhatsApp messages. Everything runs through the ChatDesq public API.

Tools

ToolWhat it doesChanges data
list_whatsapp_numbersConnected WhatsApp Business numbersNo
list_contacts, get_contactSearch contacts by name, phone, email, tag or segmentNo
list_tagsContact tagsNo
list_templatesMessage templates with Meta approval status and categoryNo
list_conversations, get_conversation_messagesInbox conversations and their messagesNo
get_message_statusDelivery status of a sent messageNo
list_broadcastsBroadcast campaigns and their countsNo
list_pipelines, list_dealsCRM pipelines, stages and dealsNo
send_text_messageOne free-form text, inside the 24-hour service windowYes
send_template_messageOne approved template to one opted-in numberYes
create_contact, update_contact, tag_contactContact records and tagsYes
create_dealA CRM deal for a contactYes

Left out on purpose: bulk broadcasts, drip enrolment, deletes and API-key rotation. An assistant can't mass-message your customers or delete data through this server. For those tasks, use the ChatDesq app.

Setup

  1. In ChatDesq, open Settings > API keys and create a key. Give it only the scopes you need; a read-only key is enough for the lookup tools.
  2. Add the server to your MCP client.

Claude Desktop (claude_desktop_config.json) or Cursor (.cursor/mcp.json):

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

Claude Code:

claude mcp add chatdesq --env CHATDESQ_API_KEY=sk_live_... -- npx -y @chatdesq/mcp-server

Optional: set CHATDESQ_API_BASE to use a different API base URL (default https://api.chatdesq.com/v1).

Example prompts

  • "Which of my WhatsApp templates are still pending approval, and which are marketing vs utility?"
  • "Find the contact with phone 9198xxxxxxx, add the tag 'vip' and create a deal worth ₹25,000."
  • "Summarise today's open conversations and draft replies; don't send anything."
  • "Did message wamid.XXXX get delivered?"

Good practice

  • Send messages only to people who have opted in to hear from you, and respect opt-outs. WhatsApp's Business Messaging Policy applies to everything you send.
  • Free-form text works only within 24 hours of the customer's last message. Outside that window, use an approved template.
  • Keep your API key secret. Don't commit it, and rotate it in ChatDesq if it leaks.

Links

ChatDesq is built by Apporio Infolabs Pvt Ltd (Noida, India). MIT licensed.

NPM
@chatdesq/mcp-server
Install Command
npm install @chatdesq/mcp-server