Connect Claude AI to WhatsApp Business in under 5 minutes.
If you don't have Claude Desktop yet, download it first:
Click the gear icon in the top-right corner of Claude Desktop, or press Ctrl+, (Windows) / Cmd+, (Mac).
In Settings, click "Developer" in the left sidebar, then click "Edit Config". This opens the file claude_desktop_config.json in your text editor.
Replace the file contents with this (or merge into existing config):
{
"mcpServers": {
"whatsapp": {
"type": "url",
"url": "https://whatsapp-mcp-server.eosspirit.workers.dev/mcp"
}
}
}
{
"mcpServers": {
"whatsapp": {
"type": "url",
"url": "https://whatsapp-mcp-server.eosspirit.workers.dev/mcp",
"headers": {
"X-API-Key": "YOUR_API_KEY_HERE"
}
}
}
}
%APPDATA%\Claude\claude_desktop_config.json~/Library/Application Support/Claude/claude_desktop_config.json
Save the file, then completely close and reopen Claude Desktop. The WhatsApp tools will now be available.
Just talk to Claude naturally. Here are some things you can ask:
Sends a WhatsApp text message to the specified number.
Retrieves your WhatsApp Business profile info.
Shows all approved/pending templates in your account.
Shows if your number is GREEN (good), YELLOW (warning), or RED (at risk). PRO
Retrieves incoming messages received via webhooks. PRO
The free and Pro plans use a shared test phone number provided by Meta. To use your own business phone number, you need a Meta Business Account:
Go to developers.facebook.com and sign in with your Facebook account.
Click "Create App" > choose "Business" > name it anything (not "WhatsApp" — Meta blocks that). Select "Connect with customers via WhatsApp" as the use case.
In the WhatsApp section of your app, you'll see:
With the Enterprise plan, we configure your own phone number on our hosted server. Or you can self-host with your own credentials.
Make sure you saved the config file and fully restarted Claude Desktop (not just closed the window — quit the app completely). Check that the JSON is valid (no trailing commas, correct brackets).
If you're on the Pro/Enterprise plan, check that your API key is correct in the config. Make sure there are no extra spaces. You can verify your key at: https://whatsapp-mcp-server.eosspirit.workers.dev/billing/api-key?email=YOUR_EMAIL
Free tier: 100 requests/hour. Pro: 1,000/hour. Enterprise: 10,000/hour. Wait or upgrade your plan.
Make sure you added the "headers": {"X-API-Key": "..."} section in your config. Free tier only shows 7 tools. Pro/Enterprise shows all 35.
The test phone number can only send to numbers that have been added as test recipients in the Meta Developer Portal. For production, you need your own verified business number.
The anti-spam system blocked the message. If allowlist is enabled, add the recipient first:
Tell Claude: "Add +1234567890 to my allowlist" then try sending again.
Check your limits with: "Show my messaging safety status"
Every outbound message passes through the MessageGuard before sending. This prevents bad prompts from turning into spam.
manage_allowlist.Enterprise customers can enable AI-powered automatic replies. When someone messages you on WhatsApp, the server calls an AI to generate and send a response automatically.
gsk_)Tell Claude: "Configure auto-reply with Groq. My API key is gsk_xxxxx. System prompt: You are a friendly customer service agent for my store. Answer in Spanish. Our website is https://mysite.com"
Incoming WhatsApp messages now get automatic AI responses. The bot remembers conversations and respects business hours if configured.
Tell Claude: "Show my auto-reply status" Tell Claude: "Disable auto-reply" Tell Claude: "Clear conversation history for +1234567890" Tell Claude: "Change provider to OpenAI with key sk_xxxxx"