Skip to main content
Glama
deenesjakoruzh
chatmaid

@chatmaid/mcp

Official
by chatmaid
OverviewSchemaRelated ServersScoreDiscussions(1)
JavaScript
Remote

@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

Related MCP server: MCP WPPConnect Server

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_inbound_messages

List messages received by your connected phone numbers (live only), optionally filtered by phoneNumberId, with page/limit pagination.

get_inbound_message

Fetch an inbound (received) message by ID (inmsg_xxx).

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

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

License

MIT © Chatmaid

Install Server
A
license - permissive license
A
quality
B
maintenance

How are these scores calculated?

Maintenance

–Maintainers
–Response time
–Release cycle
–Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/chatmaid/mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server