Help Center / Tutorials

Connect WhatsApp to Claude AI

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

  1. A Wassenger account with at least one connected WhatsApp device. Don't have one yet? Create your free account here.
  2. Your API key — this is a unique token that authorizes Claude to access your WhatsApp. Get your API key here from Settings → API Keys.
Keep your API key safe. Do not share it publicly. You can regenerate it at any time from your dashboard.

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}}"
    }
  }
}
Already have other integrations? Add the "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:

I found 3 connected devices on your Wassenger account:

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:

✅ Message sent successfully!

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:

Here are your 5 most recent conversations on the Sales device:

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:

"Show me my connected WhatsApp devices"

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:

"Send a WhatsApp message to +1234567890 saying: Hello from Claude AI!"

You'll see a confirmation with the sender, recipient, and message content. The message arrives on WhatsApp instantly.

3. Read your conversations:

"Show me my last 10 WhatsApp conversations with the contact name and last message"

Claude will show a formatted table of your recent chats with names, last message preview, and timestamps.

4. Get an AI insight:

"Summarize what my contacts have been asking about today"

This is where Claude shines — it reads your messages, understands the context, and gives you a human-readable summary like:

"You received 12 messages today. 5 are about order status, 3 are asking for pricing info, 2 are support requests, and 2 are general greetings."

5. Your first automation:

"Check my unread messages. For each one, draft a friendly and professional reply. Show me the drafts before sending."

Claude reads each unread message, drafts a personalized response, and presents them for your approval:

Unread from John D.: "When will my order arrive?" Draft reply: "Hi John! Your order #4521 is on its way and should arrive by Thursday. I'll send you the tracking link shortly. Let me know if you need anything else!"

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

"Read my unread messages and respond to customer questions with helpful answers"

2. Smart Lead Follow-Up

"Which contacts messaged me in the last 24 hours but haven't received a reply? Draft a follow-up for each one"

Claude will identify unanswered conversations and draft personalized follow-ups:

Found 3 contacts without a reply: Sarah M., John D., and Maria Lopez. Here are my suggested follow-ups...

3. Broadcast Campaigns

"Send a promotional message to my last 20 active contacts saying: Special offer this week! 20% off all services. Reply YES to claim!"

4. Sentiment Analysis

"Analyze my last 50 conversations — how many customers seem happy, neutral, or frustrated?"

Claude reads through your conversations and gives you a breakdown:

Out of 50 conversations: 32 positive (64%), 12 neutral (24%), 6 frustrated (12%). The main complaints are about delivery times and response speed.

5. Group Management

"Create a WhatsApp group called 'Marketing Team' and add these numbers: +1 415 555 0001, +1 415 555 0002, +1 415 555 0003"

6. Monthly Reports

"Give me a report of my WhatsApp activity this month"
This month: 847 messages sent, 623 received, 45 new conversations. Most active day: Tuesday. Most active contact: Sarah M. (34 messages). Average response time: 12 minutes.

7. Instant Translation

"Translate this to Spanish and send it to +1234567890: Your order has shipped and will arrive in 2-3 business days"
✅ Sent to +1234567890: "Su pedido ha sido enviado y llegará en 2-3 días hábiles"

8. Scheduled Messages

"Send a reminder to +1234567890 tomorrow at 9 AM saying: Don't forget our meeting at 2 PM today!"

9. Media Management

"Show me all images and documents received today"

10. Team Workflows

"Assign the next 5 unread chats to my support team"

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


Was this article helpful?

Thank you for your feedback!

Related articles


Categories

FAQ