WhatsApp MCP for Gemini
Give Gemini a real WhatsApp Business API. Register the Gambot MCP server in your Gemini CLI settings, add your token, and ask Gemini to send WhatsApp messages, templates and campaigns.
What this enables
- Ask Gemini to send a WhatsApp free-text message (inside the 24h window) or an approved template.
- Create, schedule and run WhatsApp campaigns; read delivery status and results.
- Query analytics and manage contacts, leads, cases and tasks from the command line.
- Gemini receives structured states and next-action guidance, so it recovers correctly (e.g. template when the window is closed).
Requirements
- A Gambot account with WhatsApp connected (create one free).
- Your Gambot token (
gmbt_…) from Gambot → Settings → General. - The Gemini CLI (or a Gemini client that supports MCP servers) and Node.js 18+.
Setup
Open Gemini settings
Edit your Gemini CLI settings file (e.g. ~/.gemini/settings.json) that holds the mcpServers map.
Register the gambot server
Add the block below, using command npx and args ["-y","gambot-mcp"].
Authenticate
Set GAMBOT_TOKEN to your gmbt_ token; the organization resolves automatically.
Use it
Start Gemini, confirm the gambot tools are discovered, and ask it to send a WhatsApp message.
Configuration (Gemini settings.json → mcpServers)
{
"mcpServers": {
"gambot": {
"command": "npx",
"args": ["-y", "gambot-mcp"],
"env": {
"GAMBOT_TOKEN": "gmbt_your_token_here"
}
}
}
}Example prompts
You Send the appointment_reminder template to +972 50-123-4567.
You List conversations waiting for a reply and summarize them.
You Schedule a WhatsApp campaign to the “newsletter” tag for Monday 09:00.
You What were the most common customer questions today?
Troubleshooting
- Server not detected? Confirm the mcpServers block is valid JSON and restart the Gemini CLI.
- AUTHENTICATION_REQUIRED? Re-copy the gmbt_ token from Settings → General.
- CONVERSATION_WINDOW_CLOSED? Expected when the 24h window is closed — Gemini should send an approved template instead.
- npx not found? Ensure Node.js 18+ is installed and on PATH.
Related
- WhatsApp MCP overview — the full server, tools and hosted option.
- Claude, ChatGPT and Cursor setup guides.
- API docs and gambot-mcp on GitHub.
Connect WhatsApp to Gemini
Create a free Gambot account, grab your token, and register the MCP server in your Gemini settings.
Frequently asked questions
How do I add the Gambot WhatsApp MCP server to Gemini?
Add a gambot entry to the mcpServers map in your Gemini CLI settings (settings.json), with command npx, args ["-y","gambot-mcp"], and your GAMBOT_TOKEN in env, then restart Gemini.
Where do I get my Gambot token?
In Gambot, go to Settings → General and copy your organization token (starts with gmbt_).
Does it need a build step?
No. Gemini runs the server on demand with npx -y gambot-mcp; you only need Node.js 18+.
Is it the official WhatsApp API?
Yes — Gambot is an official Meta Business Solution Provider running on the authorized WhatsApp Business (Cloud) API.