Skip to content
Back to search

mcp-server

ChatDesq MCP server: WhatsApp Business API (contacts, templates, inbox, CRM deals, single messages) for Claude, Cursor and other AI assistants

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/chatdesq--mcp-server/badge.svg)](/listings/chatdesq--mcp-server)

HTML

<a href="/listings/chatdesq--mcp-server"><img src="/api/listings/chatdesq--mcp-server/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

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

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 80 lines
  1. # ChatDesq MCP Server
  2. Connect Claude, Cursor and other AI assistants to your [ChatDesq](https://chatdesq.com) workspace. ChatDesq is a
  3. WhatsApp Business API platform for Indian D2C brands, with a ₹0 platform fee: you pay only per message.
  4. With this server, an assistant can look up contacts, read inbox conversations, check template approval and message
  5. delivery status, manage CRM deals, and send single WhatsApp messages. Everything runs through the
  6. [ChatDesq public API](https://api.chatdesq.com/v1/openapi.json).
  7. ## Tools
  8. | Tool | What it does | Changes data |
  9. |---|---|---|
  10. | `list_whatsapp_numbers` | Connected WhatsApp Business numbers | No |
  11. | `list_contacts`, `get_contact` | Search contacts by name, phone, email, tag or segment | No |
  12. | `list_tags` | Contact tags | No |
  13. | `list_templates` | Message templates with Meta approval status and category | No |
  14. | `list_conversations`, `get_conversation_messages` | Inbox conversations and their messages | No |
  15. | `get_message_status` | Delivery status of a sent message | No |
  16. | `list_broadcasts` | Broadcast campaigns and their counts | No |
  17. | `list_pipelines`, `list_deals` | CRM pipelines, stages and deals | No |
  18. | `send_text_message` | One free-form text, inside the 24-hour service window | Yes |
  19. | `send_template_message` | One approved template to one opted-in number | Yes |
  20. | `create_contact`, `update_contact`, `tag_contact` | Contact records and tags | Yes |
  21. | `create_deal` | A CRM deal for a contact | Yes |
  22. **Left out on purpose:** bulk broadcasts, drip enrolment, deletes and API-key rotation. An assistant can't
  23. mass-message your customers or delete data through this server. For those tasks, use the ChatDesq app.
  24. ## Setup
  25. 1. In ChatDesq, open **Settings > API keys** and create a key. Give it only the scopes you need; a read-only key is
  26. enough for the lookup tools.
  27. 2. Add the server to your MCP client.
  28. **Claude Desktop** (`claude_desktop_config.json`) or **Cursor** (`.cursor/mcp.json`):
  29. ```json
  30. {
  31. "mcpServers": {
  32. "chatdesq": {
  33. "command": "npx",
  34. "args": ["-y", "@chatdesq/mcp-server"],
  35. "env": { "CHATDESQ_API_KEY": "sk_live_..." }
  36. }
  37. }
  38. }
  39. ```
  40. **Claude Code:**
  41. ```bash
  42. claude mcp add chatdesq --env CHATDESQ_API_KEY=sk_live_... -- npx -y @chatdesq/mcp-server
  43. ```
  44. Optional: set `CHATDESQ_API_BASE` to use a different API base URL (default `https://api.chatdesq.com/v1`).
  45. ## Example prompts
  46. - "Which of my WhatsApp templates are still pending approval, and which are marketing vs utility?"
  47. - "Find the contact with phone 9198xxxxxxx, add the tag 'vip' and create a deal worth ₹25,000."
  48. - "Summarise today's open conversations and draft replies; don't send anything."
  49. - "Did message wamid.XXXX get delivered?"
  50. ## Good practice
  51. - Send messages only to people who have opted in to hear from you, and respect opt-outs. WhatsApp's Business
  52. Messaging Policy applies to everything you send.
  53. - Free-form text works only within 24 hours of the customer's last message. Outside that window, use an approved
  54. template.
  55. - Keep your API key secret. Don't commit it, and rotate it in ChatDesq if it leaks.
  56. ## Links
  57. - ChatDesq: [chatdesq.com](https://chatdesq.com)
  58. - Pricing (₹0 platform fee, pay per message): [chatdesq.com/pricing](https://chatdesq.com/pricing)
  59. - WhatsApp API cost calculator: [chatdesq.com/tools/whatsapp-cost-calculator](https://chatdesq.com/tools/whatsapp-cost-calculator)
  60. - Support: hello@chatdesq.com
  61. ChatDesq is built by Apporio Infolabs Pvt Ltd (Noida, India). MIT licensed.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.