@chatmaid/mcp

MCP server for the Chatmaid WhatsApp Developers API. Send WhatsApp messages and manage your account from Claude Code, Cursor, Windsurf, Claude Desktop, and any other MCP-compatible AI client.

Install

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

Environment variables

| Variable | Required | Description | | --------------------- | -------- | ----------------------------------------------------------------------------------- | | CHATMAID_API_KEY | Yes | Your API key. Use sk_test_* for sandbox, sk_live_* for production. | | CHATMAID_BASE_URL | No | Override the API base URL. Defaults to https://developers-api.chatmaid.net. |

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

Tools

| Tool | Description | | -------------------- | --------------------------------------------------------------------------- | | send_message | Send a WhatsApp message: fromPhoneId (use list_phone_numbers to find), to in E.164, plus content and/or mediaUrls, optional idempotencyKey. | | list_messages | List recent messages, optionally filtered by status, phoneNumberId, with page/limit pagination. | | get_message | Fetch a message by ID, including final status and timestamps. | | list_phone_numbers | List phone numbers registered to the account (scoped to your API key environment). | | get_phone_number | Get details for a single phone number. Accepts internal ID or E.164. | | get_phone_status | Check if a phone number is currently connected to WhatsApp. Accepts internal ID or E.164. | | get_account | Get current account info (accountId, name, email, subscription status). | | get_usage | Get usage stats for period = day | week | month (defaults to month). |

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."
• "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.

License

MIT © Chatmaid