Connect WhatsApp to Claude AI
Connect your Wassenger WhatsApp numbers to Claude, the most powerful AI assistant, and automate messages, conversations, and workflows — all from natural language.
This guide shows you how to set up the integration step by step, with four different methods depending on how you use Claude.
What Is This?
This integration creates a direct bridge between Claude and your WhatsApp. Instead of manually copying messages back and forth, Claude can read, send, and manage your WhatsApp conversations directly.
Once connected, you simply tell Claude what to do:
- "Send a WhatsApp message to +1234567890 saying hello"
- "Show me my unread conversations"
- "Reply to all pending customer messages"
This is powered by the MCP (Model Context Protocol) — the same standard used by all major AI tools to connect with external services.
Why Claude?
Claude stands out as the most capable AI for WhatsApp automation:
- Thinks before acting — Claude reasons through complex tasks instead of rushing to respond
- Handles multi-step workflows — Ask Claude to read messages, analyze sentiment, and draft replies in one go
- Understands full context — Claude reads entire conversations to give relevant, personalized responses
- Available everywhere — Desktop app, web, CLI, and API
What You Need
- A Wassenger account with at least one connected WhatsApp device. Don't have one yet? Create your free account here.
- Your API key — this is a unique token that authorizes Claude to access your WhatsApp. Get your API key here from Settings → API Keys.
Choose Your Method
| I want... | Best method |
|---|---|
| The easiest setup possible | Claude.ai Web & Desktop |
| WhatsApp always available on my desktop | Claude.ai Web & Desktop |
| To use it from my terminal or code editor | Claude Code CLI |
| To build my own app with AI + WhatsApp | Anthropic API |
Claude.ai Web & Claude Desktop App
Works on both claude.ai and the Desktop app. No installation required — this is the fastest way to get started.
Step 1: Open Customize
Open Claude (web or desktop) and click the Customize icon in the left sidebar.
Step 2: Go to Connectors
In the Customize panel, click Connectors.
Step 3: Add Custom Connector
Click the + button at the top, then select Add custom connector.
Step 4: Paste Your MCP URL
In the modal, enter a name (e.g., "WhatsApp") and paste your MCP server URL:
https://api.wassenger.com/mcp?key={{apikey}}
Then click Add.
Step 5: Start Using It
Open a new conversation and try typing: "Show me my connected WhatsApp devices"
Claude Desktop App — Alternative: Manual Configuration File
You can also add the connector by editing a configuration file directly:
- Mac:
~/Library/Application Support/Claude/claude_desktop_config.json - Windows:
%APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"whatsapp": {
"type": "http",
"url": "https://api.wassenger.com/mcp?key={{apikey}}"
}
}
}
"whatsapp": { ... } block inside your existing "mcpServers" section, separated by a comma.
After editing the file, restart Claude Desktop (Cmd + Q on Mac, Alt + F4 on Windows) and reopen it.
Claude Code CLI
For developers working from the terminal.
Add the server with a single command:
claude mcp add whatsapp "https://api.wassenger.com/mcp?key={{apikey}}"
Or create a .mcp.json file in your project root:
{
"servers": {
"whatsapp": {
"type": "http",
"url": "https://api.wassenger.com/mcp?key={{apikey}}"
}
}
}
Restart Claude Code and verify by typing: "Ping the WhatsApp MCP server"
Anthropic API
For building products and autonomous agents.
Python
import anthropic
client = anthropic.Anthropic()
response = client.messages.create(
model="claude-sonnet-4-20250514",
max_tokens=1024,
messages=[
{"role": "user", "content": "Send a WhatsApp message to +1234567890 saying hello"}
],
mcp_servers=[
{
"type": "url",
"url": "https://api.wassenger.com/mcp?key={{apikey}}",
"name": "whatsapp"
}
]
)
JavaScript
import Anthropic from '@anthropic-ai/sdk'
const client = new Anthropic()
const response = await client.messages.create({
model: 'claude-sonnet-4-20250514',
max_tokens: 1024,
messages: [
{ role: 'user', content: 'Send a WhatsApp to +1234567890 saying hello' }
],
mcp_servers: [
{
type: 'url',
url: 'https://api.wassenger.com/mcp?key={{apikey}}',
name: 'whatsapp'
}
]
})
For full API documentation, visit the Anthropic MCP docs.
See It In Action
Here's what a real conversation with Claude looks like once WhatsApp is connected:
You: "Show me my connected WhatsApp devices"
Claude:
| Device | Phone | Status |
|---|---|---|
| Sales | +1 415 555 1234 | ✅ Online |
| Support | +1 415 555 5678 | ✅ Online |
| Marketing | +44 20 7946 0958 | ✅ Online |
All 3 devices are online and ready to send messages. Which one would you like to use?
You: "Send a message from Sales to +1 212 555 9876 saying: Hi! Just checking in on your order. Let me know if you need anything."
Claude:
From: Sales (+1 415 555 1234) To: +1 212 555 9876 Message: Hi! Just checking in on your order. Let me know if you need anything.
The message was delivered. Would you like to do anything else?
You: "Show me my last 5 conversations"
Claude:
| Contact | Last Message | Time | Status |
|---|---|---|---|
| Sarah M. (+1 212 555 9876) | "Thanks, I'll check it out!" | 2 min ago | Active |
| John D. (+44 77 1234 5678) | "When will my order arrive?" | 15 min ago | Pending |
| Maria Lopez (+34 612 345 678) | "Perfecto, gracias!" | 1 hour ago | Active |
| Alex Chen (+1 310 555 4321) | "Can I change my delivery address?" | 3 hours ago | Pending |
| Emma W. (+49 151 1234 5678) | "Sent a photo" | Yesterday | Resolved |
You have 2 pending conversations that haven't been replied to. Want me to draft responses?
Your First 5 Minutes
Once connected, try these prompts in order:
1. Verify your connection:
Claude will respond with a list of your devices, their phone numbers, and whether they're online — confirming everything works.
2. Send a test message:
You'll see a confirmation with the sender, recipient, and message content. The message arrives on WhatsApp instantly.
3. Read your conversations:
Claude will show a formatted table of your recent chats with names, last message preview, and timestamps.
4. Get an AI insight:
This is where Claude shines — it reads your messages, understands the context, and gives you a human-readable summary like:
5. Your first automation:
Claude reads each unread message, drafts a personalized response, and presents them for your approval:
Unread from Alex Chen: "Can I change my delivery address?" Draft reply: "Hi Alex! Of course, I can help with that. Could you send me the new address and I'll update it right away?"
Should I send these replies?
10 Things You Can Do
Here are powerful prompts you can use right away:
1. Customer Support on Autopilot
2. Smart Lead Follow-Up
Claude will identify unanswered conversations and draft personalized follow-ups:
3. Broadcast Campaigns
4. Sentiment Analysis
Claude reads through your conversations and gives you a breakdown:
5. Group Management
6. Monthly Reports
7. Instant Translation
8. Scheduled Messages
9. Media Management
10. Team Workflows
Troubleshooting
Claude doesn't show WhatsApp tools
- Verify your API key is correct (no extra spaces)
- Restart Claude completely (quit and reopen)
- Confirm your Wassenger account has at least one connected device
Message failed to send
- Check that your device is online in your Wassenger dashboard
- Ensure the phone number includes the country code (e.g., +1 for US)
Authentication error
- Your API key may have expired — generate a new one in Settings → API Keys
Claude responds but doesn't execute actions
- Look for the tools icon in Claude's interface
- Start a new conversation if the current one doesn't show tools
Related Resources
- MCP Server Documentation — Full technical reference with all available tools
- API Key Management — Create and manage your API keys
