WhatsApp MCP Server: connect your WhatsApp number to Claude
Let Claude read your WhatsApp chats, reply to customers, post reports to your team groups and pull lead data, all from a normal chat. WapDeskPro hosts the MCP server at https://wapdeskpro.com/mcp: paste the URL into Claude, log in and pick your number.
WapDeskPro is an unofficial WhatsApp API built on WhatsApp Web (the open-source Baileys library). It is not affiliated with or endorsed by Meta or WhatsApp. How to use it safely โ
What Claude can do with your WhatsApp
Ask in plain English (or Hinglish). Each item below is a real tool on the server.
Set up in 2 minutes
First, create a free WapDeskPro account and connect your WhatsApp number by scanning the QR code in the dashboard.
- In Claude, open Settings โ Connectors (claude.ai/settings/connectors) and click Add custom connector.
- Name it WapDeskPro and paste the server URL:
https://wapdeskpro.com/mcp
- Click Connect. Log in with your WapDeskPro account, choose which WhatsApp number Claude may use, and click Allow.
No API key to copy. Connectors you add on claude.ai also show up in the Claude Desktop app. Disconnect anytime from Claude's Connectors page. Each connection is tied to one WhatsApp number; add the connector again for a second number. Custom connectors are a Claude feature, so availability depends on your Claude plan.
The same steps, with a copy button for the URL, are in your dashboard under AI Agent โ API & MCP.
Claude Code โ add the remote server, then run /mcp inside Claude Code to log in:
claude mcp add --transport http wapdeskpro https://wapdeskpro.com/mcp
Cursor โ add it to ~/.cursor/mcp.json and sign in when Cursor asks:
{
"mcpServers": {
"wapdeskpro": { "url": "https://wapdeskpro.com/mcp" }
}
}
Clients without OAuth can send the headers x-maytapi-key, x-product-id and x-phone-id with every request to https://wapdeskpro.com/mcp. Copy the values from AI Agent โ API & MCP โ Developer options.
WA_API_URL, WA_PRODUCT_ID, WA_PHONE_ID and WA_API_KEY. Until it's published, use the remote URL above.Full reference: MCP server docs ยท Step-by-step guide: How to connect WhatsApp to Claude
Tools reference
14 tools. Read-only tools carry the MCP readOnlyHint, so clients can treat them differently from tools that send messages.
| Tool | What it does | Inputs |
|---|---|---|
whatsapp_status | Is the number connected? Shows number, name and plan | โ |
list_conversations | Contacts who chatted with this number, newest first, with message and AI reply counts and the AI-paused flag | search (optional) |
read_chat | Message history with one contact, marked customer / AI / agent | contact, limit (1โ500, default 50) |
send_message sends | Send a text. Replies in an existing chat or starts a new one (new numbers count toward your plan's recipient limit) | to, text, pause_ai (optional) |
ai_reply sends | Your configured AI agent (Gemini, OpenAI or Claude) writes and sends a reply to the latest message | contact |
set_ai_paused | Pause (human takeover) or resume AI auto-reply for one contact | contact, paused |
get_agent_config | AI auto-reply settings: on/off, provider, model, system prompt, CRM / Sheet sync | โ |
set_agent_enabled | Turn AI auto-reply on or off for this number | enabled |
push_contact_to_crm | Send a contact to your Google Sheet or CRM webhook | contact |
list_groups | WhatsApp groups this number is in (id, name, member count) | search (optional) |
send_group_message sends | Send text to a group by id or exact/partial name | group, text |
get_activity | Totals, new contacts and per-contact counts for a time range; optionally every message text (up to 1,000). Default: last 24 hours | since, until (ISO 8601), include_messages |
search_messages | Search all messages for a word or phrase, newest first | query, since, limit (1โ500) |
export_chat | Export one contact or all chats | contact (optional), format: txt / csv / json |
MCP sending is text only. Images, video, documents and audio are available through the REST API.
Use cases
Real estate & sales teams
"List everyone who enquired about 2BHK this week and push them to the Sheet." Then: "Send the evening summary to the Sales group."
Clinics & service businesses
Ask Claude to read the day's chats and draft follow-ups. Send only the ones you approve.
Founders & managers
A morning report in your team group: new leads, total incoming messages and how many the AI answered.
Support teams & developers
Search past chats for an order number, take over from the bot with pause_ai, or use the tools from Claude Code while building on the Maytapi-compatible REST API.
Security and privacy
Built on the standard MCP authorization flow.
OAuth 2.1 with PKCE
You log in on wapdeskpro.com, never inside Claude, and approve one WhatsApp number. The token can't touch your other numbers.
Short-lived tokens
Access tokens expire after 1 hour. Refresh tokens rotate on every use and expire after 90 days. Tokens are stored only as SHA-256 hashes.
Same limits as the API
Every tool calls the WapDeskPro REST API with that number's credentials, so authentication and plan limits are identical. Disconnect anytime from Claude.
Your data
WapDeskPro stores chats to power chat history and the AI agent. The MCP server itself is stateless. See our privacy policy. Treat API tokens like passwords.
- Message people who contacted you or opted in. Don't let Claude cold-message lists.
- Ask Claude to draft first; keep approval on for
send_message,send_group_messageandai_reply. - Keep volume and pace human; avoid the same text to many new numbers. Use a number with history, not a fresh SIM.
Pricing
The MCP tools are available on every plan at no extra cost. Messages sent through MCP count exactly like API messages: a new number is one recipient, and a group is one recipient.
- โ 1 WhatsApp number
- โ 30 unique recipients
- โ MCP server for Claude
- โ REST API & webhooks
- โ Unlimited recipients
- โ MCP server for Claude
- โ Extra numbers โน450/month each
- โ Chat history (1 month)
WhatsApp MCP FAQ
What is a WhatsApp MCP server?
MCP (Model Context Protocol) is an open standard that lets AI assistants like Claude use outside tools. A WhatsApp MCP server exposes WhatsApp actions (read chats, send messages, list groups) as tools the assistant can call. WapDeskPro's server is hosted, so you don't run anything yourself.
How do I connect WhatsApp to Claude?
Add a custom connector in Claude (Settings โ Connectors) with the URL https://wapdeskpro.com/mcp, click Connect, log in to WapDeskPro and approve your number. The number must already be connected to WapDeskPro by QR scan.
Does it work with Claude Desktop, Claude Code and Cursor?
Yes. Connectors added on claude.ai are available in Claude Desktop. Claude Code and Cursor can add https://wapdeskpro.com/mcp as a remote server and log in with OAuth. A local stdio package is coming soon.
Can I use it with ChatGPT or other AI agents?
Any MCP client that supports remote Streamable HTTP servers with OAuth can use the URL; clients without OAuth can use API headers. ChatGPT supports custom MCP connectors in developer mode on some plans. We test with Claude.
Is this the official WhatsApp Business API?
No. WapDeskPro is an unofficial API that links your number through WhatsApp Web (Baileys). No Meta verification and no per-message fee, but also no green tick, and WhatsApp can restrict numbers that send spam. Compare the two โ
Will Claude send messages without asking me?
Claude asks for permission before using connector tools unless you change that in its settings. Keep approval on for the tools that send messages.
Can Claude send images or PDFs through MCP?
Not yet. The MCP tools send text only. Images, video, documents and audio are available through the REST API.
Is the WhatsApp MCP server free?
The MCP tools are available on every plan at no extra cost. The free trial covers 30 unique recipients; Pro removes the limit.
Give Claude your WhatsApp in 2 minutes
Create a free account, scan the QR code, paste one URL into Claude.
Create free account