How to Connect WhatsApp to Claude (MCP Setup Guide)

Most businesses in India already run on WhatsApp: leads come in there, customers ask questions there, and the team shares updates in WhatsApp groups. Claude is great at reading, summarising and writing, but on its own it can't see your WhatsApp. The bridge is MCP, the Model Context Protocol. In this guide you'll connect a WhatsApp number to Claude in about two minutes, see what Claude can do with it, and learn how to use it without putting your number at risk.

What is MCP, in one paragraph?

MCP is an open standard that lets AI assistants call outside tools. An "MCP server" publishes a list of tools, each with a name, a description and inputs, and an MCP client like Claude decides when to call them during a conversation. Claude (web, desktop and mobile), Claude Code, Cursor and a growing list of other apps are MCP clients. So "connecting WhatsApp to Claude" really means giving Claude an MCP server that has WhatsApp tools.

What you need before you start

  1. A WapDeskPro account. Sign up free. The trial lets you message 30 unique recipients and needs no credit card.
  2. Your WhatsApp number connected to WapDeskPro. In the dashboard, scan the QR code with WhatsApp on your phone (Linked devices), the same way WhatsApp Web works.
  3. A Claude account that can add custom connectors, or Claude Code / Cursor if you're a developer.
An honest note: WapDeskPro is an unofficial WhatsApp API. It works through WhatsApp Web using the open-source Baileys library. It is not Meta's WhatsApp Business (Cloud) API and is not affiliated with Meta. That's what makes setup instant and affordable, and it's why the safe-use section below matters. Not sure which route suits you? Read WhatsApp MCP vs WhatsApp Business API.

Option 1: Add WhatsApp as a Claude connector (recommended)

WapDeskPro hosts a remote MCP server at:

https://wapdeskpro.com/mcp

It uses the Streamable HTTP transport and OAuth login, which is exactly what Claude's custom connectors expect.

  1. Open Claude and go to Settings → Connectors.
  2. Click Add custom connector.
  3. Name it WapDeskPro and paste https://wapdeskpro.com/mcp as the URL.
  4. Click Connect. A WapDeskPro window opens.
  5. Log in with your WapDeskPro account, choose the WhatsApp number Claude should use, and click Allow.

You're sent back to Claude and the connector shows as connected. There's no API key to copy: Claude receives a token that only works for the number you picked. Connectors you add on claude.ai are also available in the Claude Desktop app. The same instructions, with a copy button for the URL, are in your dashboard under AI Agent → API & MCP.

Want a second number? Add the connector again and pick the other number. Want to stop? Disconnect from Claude's Connectors page.

Option 2: Claude Code, Cursor and other MCP clients

Developer tools can use the same remote URL and the same OAuth login.

Claude Code: add the server, then run /mcp inside Claude Code and choose WapDeskPro to log in.

claude mcp add --transport http wapdeskpro https://wapdeskpro.com/mcp

Cursor: add this to ~/.cursor/mcp.json (or .cursor/mcp.json in a project) and sign in when Cursor prompts you.

{
  "mcpServers": {
    "wapdeskpro": { "url": "https://wapdeskpro.com/mcp" }
  }
}

Clients without OAuth can authenticate with headers instead: x-maytapi-key (your phone token), x-product-id and x-phone-id. Copy them from the dashboard's Developer options. Your phone token gives full access to that number, so keep it out of shared files.

Coming soon: a local stdio package for Claude Desktop and Cursor, configured with the environment variables WA_API_URL, WA_PRODUCT_ID, WA_PHONE_ID and WA_API_KEY. Until it's published, use the remote URL.

What Claude can do once WhatsApp is connected

The server gives Claude 14 tools. You don't need to remember their names; just ask in plain English (or Hinglish, which Claude handles fine).

Read and understand chats

Send messages

Run your WhatsApp AI agent and CRM

The full table with inputs is on the WhatsApp MCP page, and the protocol details are in the MCP docs. MCP sends text only; for images, PDFs and audio use the REST API.

Five prompts to try first

  1. "Check if my WhatsApp is connected." A safe first test using whatsapp_status.
  2. "Who messaged us in the last 24 hours? Group them into new enquiries, follow-ups and complaints."
  3. "Read my chat with 919876543210 and draft a polite reply about the delayed delivery. Don't send yet."
  4. "Make today's report (new contacts, total incoming messages, how many the AI answered) and post it in the 'Sales Team' group."
  5. "Find everyone who asked about price since Monday and push them to the CRM sheet."

Notice prompt 3 says "don't send yet". That habit matters; more on it below.

Troubleshooting

Use it safely: protect your number

Because this is a WhatsApp Web based connection, WhatsApp treats your number like a normal account using linked devices, and accounts that behave like spammers get restricted. An AI assistant that can send messages makes it easy to over-send, so set some rules:

Our guide to sending WhatsApp messages without getting banned goes deeper.

Security in short

The remote connector uses OAuth 2.1 with PKCE. You log in on wapdeskpro.com, not inside Claude, and you approve one specific number. Access tokens last one hour, refresh tokens rotate on every use, and tokens are stored only as hashes. Every tool goes through the same WapDeskPro API, so the same authentication and plan limits apply as when you call the API directly.

Wrapping up

Connecting WhatsApp to Claude takes one URL and one login: https://wapdeskpro.com/mcp. From there Claude can read your chats, write replies, build daily reports for your team group and keep your CRM updated, while you stay in control of what gets sent. The MCP tools are available on every plan, including the free trial; when you outgrow 30 recipients, Pro is ₹625/month (₹1,250, limited-time offer).

Connect WhatsApp to Claude today

Free trial: 30 recipients, no credit card. Scan the QR, paste one URL into Claude.

Create free account →