MCP

@chatmaid/mcp

MCP server for the Chatmaid WhatsApp Developers API. Send WhatsApp messages to contacts and groups, read the replies, and check delivery from Claude Code, Cursor, Windsurf, Claude Desktop, VS Code, and any other MCP-compatible AI client.

• Docs: chatmaid.net/docs/mcp
• API keys: developers.chatmaid.net
• Chatmaid: chatmaid.net

Install

Every client runs the same command, npx -y @chatmaid/mcp, with your API key in CHATMAID_API_KEY. Replace sk_test_xxx with your key after installing.

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "chatmaid": {
      "command": "npx",
      "args": ["-y", "@chatmaid/mcp"],
      "env": {
        "CHATMAID_API_KEY": "sk_test_xxx_or_sk_live_xxx"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "chatmaid": {
      "command": "npx",
      "args": ["-y", "@chatmaid/mcp"],
      "env": { "CHATMAID_API_KEY": "sk_test_xxx_or_sk_live_xxx" }
    }
  }
}

Claude Code / CLI

claude mcp add chatmaid \
  --env CHATMAID_API_KEY=sk_test_xxx \
  -- npx -y @chatmaid/mcp

VS Code

Add to .vscode/mcp.json (VS Code prompts for the key and stores it securely):

{
  "inputs": [
    {
      "type": "promptString",
      "id": "chatmaid-api-key",
      "description": "Chatmaid API key (sk_test_* or sk_live_*)",
      "password": true
    }
  ],
  "servers": {
    "chatmaid": {
      "command": "npx",
      "args": ["-y", "@chatmaid/mcp"],
      "env": { "CHATMAID_API_KEY": "${input:chatmaid-api-key}" }
    }
  }
}

Windsurf

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

{
  "mcpServers": {
    "chatmaid": {
      "command": "npx",
      "args": ["-y", "@chatmaid/mcp"],
      "env": { "CHATMAID_API_KEY": "sk_test_xxx_or_sk_live_xxx" }
    }
  }
}

Environment variables

Get a key at https://developers.chatmaid.net/dashboard/api-keys.

Tools

Example prompts

Once installed, you can ask your agent things like:

• "Send a WhatsApp message from my business number to +14155551234 saying the order has shipped."
• "What phone numbers are connected to my Chatmaid account?"
• "Check if message msg_abc123 was delivered."
• "Show me the latest messages received on my business number."
• "How much of my WhatsApp quota have I used this month?"

The agent will call the right tool automatically.

Safety

• Always use sk_test_* keys when prototyping with agents. Messages sent with test keys are simulated end-to-end through Chatmaid's sandbox — nothing goes out to WhatsApp.
• Promote to sk_live_* only when you've confirmed the agent's behavior.

Source

Open-source at github.com/chatmaid/mcp. PRs welcome. Listed in the official MCP Registry as io.github.chatmaid/mcp.

License

MIT © Chatmaid