Model Context Protocol ยท Claude connector

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.

Start free: connect WhatsApp See the setup steps

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.

Understand your inbox
"Who messaged us today and what did they want?" Claude lists conversations and reads chats, then summarises.
Reply without opening WhatsApp
Send a text to a contact or a new number, and optionally pause your AI bot for that person so a human takes over.
Daily reports to team groups
Count incoming messages, new contacts and AI replies for any time range, then post the summary in your team group.
Find any message
"Who asked about price this week?" Full-text search across every chat, with a date filter.
Control your AI agent
Turn auto-reply on or off, check the provider, model and prompt, pause it per contact, or make it answer now.
Leads to your CRM
Push a contact's name, number, first and last message to the Google Sheet or CRM webhook you set up.
Work with groups
List the groups your number is in and send a message to one by name or id. WhatsApp *bold* formatting works.
Export chats
Export one contact's chat, or all chats, as TXT, CSV or JSON for records or analysis.

Set up in 2 minutes

First, create a free WapDeskPro account and connect your WhatsApp number by scanning the QR code in the dashboard.

Recommended Claude (claude.ai, Desktop, mobile) Remote connector with OAuth login
  1. In Claude, open Settings โ†’ Connectors (claude.ai/settings/connectors) and click Add custom connector.
  2. Name it WapDeskPro and paste the server URL:
https://wapdeskpro.com/mcp
  1. 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.

Developers Claude Code, Cursor & other MCP clients Same remote URL

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.

Coming soon: a local stdio package for Claude Desktop and Cursor, configured with 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.

ToolWhat it doesInputs
whatsapp_statusIs the number connected? Shows number, name and planโ€”
list_conversationsContacts who chatted with this number, newest first, with message and AI reply counts and the AI-paused flagsearch (optional)
read_chatMessage history with one contact, marked customer / AI / agentcontact, limit (1โ€“500, default 50)
send_message sendsSend 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 sendsYour configured AI agent (Gemini, OpenAI or Claude) writes and sends a reply to the latest messagecontact
set_ai_pausedPause (human takeover) or resume AI auto-reply for one contactcontact, paused
get_agent_configAI auto-reply settings: on/off, provider, model, system prompt, CRM / Sheet syncโ€”
set_agent_enabledTurn AI auto-reply on or off for this numberenabled
push_contact_to_crmSend a contact to your Google Sheet or CRM webhookcontact
list_groupsWhatsApp groups this number is in (id, name, member count)search (optional)
send_group_message sendsSend text to a group by id or exact/partial namegroup, text
get_activityTotals, new contacts and per-contact counts for a time range; optionally every message text (up to 1,000). Default: last 24 hourssince, until (ISO 8601), include_messages
search_messagesSearch all messages for a word or phrase, newest firstquery, since, limit (1โ€“500)
export_chatExport one contact or all chatscontact (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.

Use it responsibly. WapDeskPro connects through WhatsApp Web, like the linked-devices feature. It is not Meta's official WhatsApp Business (Cloud) API, and WhatsApp can restrict numbers that look like spam. With an AI that can send messages:
  • 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_message and ai_reply.
  • Keep volume and pace human; avoid the same text to many new numbers. Use a number with history, not a fresh SIM.
More tips: send WhatsApp messages without getting banned.

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.

Trial
โ‚น0
Forever free ยท no credit card
  • โœ“ 1 WhatsApp number
  • โœ“ 30 unique recipients
  • โœ“ MCP server for Claude
  • โœ“ REST API & webhooks
Start Free Trial

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