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
- A WapDeskPro account. Sign up free. The trial lets you message 30 unique recipients and needs no credit card.
- 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.
- A Claude account that can add custom connectors, or Claude Code / Cursor if you're a developer.
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.
- Open Claude and go to Settings → Connectors.
- Click Add custom connector.
- Name it WapDeskPro and paste
https://wapdeskpro.com/mcpas the URL. - Click Connect. A WapDeskPro window opens.
- 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.
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
list_conversations: who has messaged this number, newest first, with message counts and whether the AI bot is paused for them.read_chat: the full history with one contact, labelled customer / AI / agent.search_messages: find a word or phrase across every chat, optionally since a date.get_activity: totals for a time range: incoming, outgoing, AI replies, active contacts and new contacts.export_chat: one chat or all chats as TXT, CSV or JSON.
Send messages
send_message: reply in an existing chat or message a new number (text).list_groupsandsend_group_message: post to a WhatsApp group by name or id.
Run your WhatsApp AI agent and CRM
get_agent_configandset_agent_enabled: check or toggle the AI auto-reply.set_ai_paused: pause the bot for one contact so a human can take over.ai_reply: have your configured AI agent (Gemini, OpenAI or Claude) answer the latest message now.push_contact_to_crm: send a lead to your Google Sheet or CRM webhook.whatsapp_status: confirm the number is connected and see its plan.
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
- "Check if my WhatsApp is connected." A safe first test using
whatsapp_status. - "Who messaged us in the last 24 hours? Group them into new enquiries, follow-ups and complaints."
- "Read my chat with 919876543210 and draft a polite reply about the delayed delivery. Don't send yet."
- "Make today's report (new contacts, total incoming messages, how many the AI answered) and post it in the 'Sales Team' group."
- "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
- "WhatsApp number no longer exists — reconnect": the number was removed from your WapDeskPro account. Re-add it and reconnect the connector.
- "This connection request has expired": the login step is valid for 15 minutes. Start again from Claude.
- Sends fail on the trial: you may have reached the 30 unique-recipient limit. See pricing.
- Status says disconnected: open the dashboard and re-scan the QR code; WhatsApp sometimes logs out linked devices.
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:
- Keep approval on for sending tools. Let Claude read freely, but confirm each
send_message,send_group_messageandai_reply. - Reply, don't blast. Use MCP for conversations and team updates with people who already talk to you. Don't ask Claude to cold-message a list of numbers.
- Draft first, then send. Review wording before it goes out, and avoid identical texts to many new contacts.
- Pace yourself and use an established number. A new SIM sending lots of messages on day one is the classic ban pattern.
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 →