WhatsApp MCP for Claude
Give Claude a real WhatsApp Business API. Run it locally in Claude Desktop, or add the hosted Gambot connector — then ask Claude to send WhatsApp messages, templates and campaigns.
What this enables
- Ask Claude to send a WhatsApp free-text message (inside the 24h window) or an approved template.
- Create, schedule and run WhatsApp campaigns; read results and delivery status.
- Summarize today’s conversations, find who is waiting for a reply, and manage contacts, leads, cases and tasks.
- Claude receives structured states and recommended next actions, so it recovers cleanly (e.g. switch to a template when the window is closed).
Requirements
- A Gambot account with WhatsApp connected (create one free).
- Your Gambot token (
gmbt_…) from Gambot → Settings → General. - For Claude Desktop: Node.js 18+ (the server runs on demand with
npx).
Option A — Claude Desktop (local)
Open the config
Edit claude_desktop_config.json (Claude Desktop → Settings → Developer → Edit Config).
Add the gambot server
Paste the config below and set GAMBOT_TOKEN to your gmbt_ token.
Restart Claude
Quit and reopen Claude Desktop; the gambot tools appear in the tools menu.
Configuration (claude_desktop_config.json)
{
"mcpServers": {
"gambot": {
"command": "npx",
"args": ["-y", "gambot-mcp"],
"env": {
"GAMBOT_TOKEN": "gmbt_your_token_here"
}
}
}
}Option B — Remote connector (hosted)
In Claude clients that support custom connectors / remote MCP servers.
Add a custom connector
Point it at the hosted Gambot MCP URL (below).
Authenticate
Complete the OAuth consent with your Gambot token — no local install needed.
Use it
Ask Claude to send WhatsApp; it uses the same tools as the local option.
Hosted MCP URL
https://gambot-mcp.azurewebsites.net/mcp
Example prompts
You Message my open leads with the promo_may template.
You Summarize today’s customer service conversations.
You Which chats have been waiting longest for a reply?
You Schedule a campaign to the “VIP” tag for tomorrow 10:00.
Troubleshooting
- Tools missing in Desktop? Fully quit and relaunch Claude after editing the config; verify JSON is valid.
- AUTHENTICATION_REQUIRED? Re-copy the gmbt_ token from Settings → General.
- CONVERSATION_WINDOW_CLOSED? Expected when the 24h window is closed — Claude should send an approved template instead.
- Connector auth loops? Re-run the OAuth consent and confirm the token belongs to the right organization.
Related
- WhatsApp MCP overview — the full server, tools and hosted option.
- Cursor, ChatGPT and Gemini setup guides.
- API docs and gambot-mcp on GitHub.
Connect WhatsApp to Claude
Create a free Gambot account, grab your token, and connect Claude in minutes.
Frequently asked questions
Can I use WhatsApp with Claude Desktop and Claude.ai?
Yes. Claude Desktop runs the server locally via npx (claude_desktop_config.json). In Claude clients that support custom connectors / remote MCP, you can instead add the hosted Gambot MCP URL and authenticate with OAuth.
Where do I get my Gambot token?
In Gambot, go to Settings → General and copy your organization token (starts with gmbt_).
Do I need to host anything for the remote connector?
No — Gambot hosts the MCP server at https://gambot-mcp.azurewebsites.net/mcp. You just authenticate with your token.
Is it the official WhatsApp API?
Yes — Gambot is an official Meta Business Solution Provider running on the authorized WhatsApp Business (Cloud) API.