Model Context Protocol · Cursor

WhatsApp MCP for Cursor

Give Cursor a real WhatsApp Business API. Add the Gambot MCP server, paste your token, and send WhatsApp messages, templates and campaigns straight from the editor.

➕ Add to Cursor (one click)Create free account →
npx gambot-mcpstdio.cursor/mcp.jsonOne-click install

What this enables

  • Ask Cursor in natural language to send a WhatsApp message or approved template to a contact.
  • Kick off, schedule or read WhatsApp campaigns and their results without leaving your editor.
  • Query analytics and manage contacts, leads, cases and tasks while you build.
  • Great for wiring WhatsApp into a project: test sends, verify templates, and inspect delivery status inline.

Requirements

  • A Gambot account with WhatsApp connected (create one free).
  • Your Gambot token (gmbt_…) from Gambot → Settings → General.
  • Node.js 18+ available on your machine (Cursor runs the server on demand with npx).

Setup

1

One-click install

Use the “Add to Cursor” button above, then paste your Gambot token into the server’s env. Or configure manually (next step).

2

Or edit .cursor/mcp.json

Add the config below to your project’s .cursor/mcp.json (or the global one) and restart Cursor.

3

Authenticate

Set GAMBOT_TOKEN to your gmbt_ token. The organization is resolved automatically from the token.

4

Use it

Open the chat, confirm the gambot tools are available, and ask it to send a WhatsApp message.

Configuration (.cursor/mcp.json)

{
  "mcpServers": {
    "gambot": {
      "command": "npx",
      "args": ["-y", "gambot-mcp"],
      "env": {
        "GAMBOT_TOKEN": "gmbt_your_token_here"
      }
    }
  }
}

Example prompts

You Send a WhatsApp to +972 50-123-4567 saying the build is deployed.

You List my approved WhatsApp templates and their variables.

You Send the order_update template to this customer with their order number.

You How many WhatsApp messages did we receive today?

You Which conversations are still waiting for a reply?

Troubleshooting

  • Tools not showing? Fully restart Cursor after editing mcp.json and check the MCP panel for the “gambot” server status.
  • Auth errors (AUTHENTICATION_REQUIRED)? Re-check the gmbt_ token in the env; it must be an organization token from Settings → General.
  • Free text rejected (CONVERSATION_WINDOW_CLOSED)? The 24-hour window is closed — the agent should send an approved template instead. This is expected WhatsApp behavior.
  • npx blocked? Ensure Node.js 18+ is installed and on PATH.

Related

Connect WhatsApp to Cursor

Create a free Gambot account, grab your token, and add the MCP server in under a minute.

Create free account →WhatsApp MCP overview

Frequently asked questions

How do I add the Gambot WhatsApp MCP server to Cursor?

Use the one-click “Add to Cursor” button, or add the gambot server block to .cursor/mcp.json with command npx, args ["-y","gambot-mcp"], and your GAMBOT_TOKEN in env, then restart Cursor.

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. Cursor 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, so it runs on the authorized WhatsApp Business (Cloud) API.