
WhatsApp MCP server: let Claude, Cursor and other AI agents send WhatsApp messages to contacts and
WhatsApp MCP server: let Claude, Cursor and other AI agents send WhatsApp messages to contacts and groups, read replies and check delivery
·
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.
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.
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"
}
}
}
}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 mcp add chatmaid \
--env CHATMAID_API_KEY=sk_test_xxx \
-- npx -y @chatmaid/mcpAdd 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}" }
}
}
}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" }
}
}
}| 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.
| Tool | Description |
|---|---|
send_message | Send a WhatsApp message: fromPhoneId (use list_phone_numbers to find), to as an E.164 number or a group JID (from list_groups), plus content and/or mediaUrls, optional idempotencyKey. |
list_groups | List the WhatsApp groups a connected phone can post to; returned id values are group JIDs usable as to in send_message. |
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). |
Once installed, you can ask your agent things like:
msg_abc123 was delivered."The agent will call the right tool automatically.
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.sk_live_* only when you've confirmed the agent's behavior.Open-source at github.com/chatmaid/mcp. PRs welcome. Listed in the official MCP Registry as io.github.chatmaid/mcp.
MIT © Chatmaid
Pick your client and paste the snippet. Each one is the same server, written the way that client expects it.
claude mcp add chatmaid -- npx -y @chatmaid/mcp{
"mcpServers": {
"chatmaid": {
"env": {
"CHATMAID_API_KEY": ""
},
"args": [
"-y",
"@chatmaid/mcp"
],
"command": "npx"
}
}
}code --add-mcp '{"name":"chatmaid","env":{"CHATMAID_API_KEY":""},"args":["-y","@chatmaid/mcp"],"command":"npx"}'[mcp_servers.chatmaid]
command = "npx"
args = ["-y", "@chatmaid/mcp"]Runs locally on your device. Your client starts the server itself, so nothing has to be hosted.
Paste this prompt into your agent. It reads this page and does the setup for you.
Read https://aiagentslisting.com/mcp/chatmaid-mcp to learn what the "@chatmaid/mcp" MCP server does and how to install it. Add it to my coding agent's MCP configuration as documented on that page, then confirm the server connects and list the tools it exposes.Agents can also browse this directory over MCP at https://aiagentslisting.com/api/mcp
claude mcp add chatmaid| Name | What it does |
|---|---|
send_message | Send a WhatsApp message via Chatmaid from one of the account's connected phones, to an individual (E.164 phone number) or to a WhatsApp group (group JID from list_groups). Returns the full message res |
list_messages | List recent WhatsApp messages with offset/limit pagination, optionally filtered by status or sender phone number ID. Response includes a `pagination` block. |
get_message | Fetch a single message by ID, including final delivery status and timestamps (createdAt, sentAt, deliveredAt, readAt, failedAt). |
list_inbound_messages | List WhatsApp messages received by the account's connected phone numbers (live environment only; sandbox keys always get an empty list). Supports offset/limit pagination and filtering by receiving pho |
get_inbound_message | Fetch a single inbound (received) message by ID, including sender, content, type, and receivedAt timestamp. |
list_groups | List the WhatsApp groups a connected phone can post to. Each group's `id` is a full group JID (e.g. [email protected]) that can be used as `to` in send_message. Sandbox (sk_test_) keys get a sta |
list_phone_numbers | List all phone numbers registered to the current Chatmaid account (scoped to the API key's environment). Returned `id` values are valid `fromPhoneId` arguments for send_message. |
get_phone_number | Get details about a single registered phone number. Accepts either the internal phone ID or an E.164 number. |
get_phone_status | Check whether a phone number is currently connected to WhatsApp and ready to send. Accepts either the internal phone ID or an E.164 number. |
get_account | Get current account profile (accountId, name, email, subscriptionStatus, aggregate stats). |
get_usage | Get usage stats for the account over a window (day, week, or month). Returns message and API request counters. |
Read live from the server on October 22, 2026.
Maintain this server? Claiming proves you own the listing and earns the last 4 points.
Claim this listingPaste this line near the top of your repository's README. The badge always renders the current score.
[](https://aiagentslisting.com/mcp/chatmaid-mcp)Nothing comparable is listed yet.
No tagged releases on record.
Connect to the AI Agents Listing MCP server at https://aiagentslisting.com/api/mcp using the HTTP transport and complete the sign-in when it asks. Then call the submit_review tool for the listing "chatmaid-mcp" with a rating from 1 to 5 and a short note on what worked and what did not.No reviews yet
Be the first to share your experience with this tool.
One email a week. New agents, MCP servers and skills, and what is actually getting traction.