Model Context Protocol · Gemini

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.

Create free account →WhatsApp MCP overview
Gemini CLIsettings.jsonnpx gambot-mcpstdio

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

1

Open Gemini settings

Edit your Gemini CLI settings file (e.g. ~/.gemini/settings.json) that holds the mcpServers map.

2

Register the gambot server

Add the block below, using command npx and args ["-y","gambot-mcp"].

3

Authenticate

Set GAMBOT_TOKEN to your gmbt_ token; the organization resolves automatically.

4

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

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.