Last reviewed October 2026
Anthropic has no WhatsApp app, number, or official connector. Claude Code's official chat channels cover Telegram, Discord and iMessage only. You can still connect the two: an MCP server lets Claude read and send your WhatsApp messages, a community Claude Code channel lets you message a running session, and agent gateways like OpenClaw turn Claude into a WhatsApp contact. This guide compares all five routes, with setup commands and the account-ban and prompt-injection risks for each.
Short answer
- To have Claude read, search and send your WhatsApp messages, install a WhatsApp MCP server. Use the maintained fork verygoodplugins/whatsapp-mcp. The original lharries repo has 6.7k stars but hasn't been updated since July 2025, and many users hit its
Client outdated (405)error. - To control Claude Code from your phone over WhatsApp, use the community WhatsApp channel plugin. Anthropic's official channels are Telegram, Discord and iMessage, and its Remote Control works through the Claude app.
- To chat with a Claude-powered assistant on WhatsApp, run OpenClaw with an Anthropic API key.
- For business messaging, use a WhatsApp Business API connector such as Composio, Bird or LetsBot. Since 15 January 2026, Meta's terms bar general-purpose AI assistants from the Business Platform. Bots that serve a business's own customers are still allowed.
Let Claude drive a live web session
Not a headless browser. A real live web session, running in this page. Claude connects to it over MCP, then clicks and types on the page while you watch - and you can take over at any time. Free for 10 minutes, no account.
The 5 Ways to Connect WhatsApp and Claude
WhatsApp MCP (maintained fork) Best MCP
verygoodplugins/whatsapp-mcp
The actively maintained fork of lharries/whatsapp-mcp. It links your personal WhatsApp as a device and lets Claude Desktop, Claude Code or Cursor search chats, read history and send messages.
Key Features
- Search contacts, list chats, read message history with context
- Send text, files and voice notes to people or groups
- Read receipts, call history, webhooks for incoming messages
- Messages stay in local SQLite; Claude only sees what a tool call returns
Installation
git clone https://github.com/verygoodplugins/whatsapp-mcp.git
cd whatsapp-mcp/whatsapp-bridge && go run . # scan the QR code
claude mcp add whatsapp -- uv --directory "$PWD/../whatsapp-mcp-server" run main.pyThis is the pick for most people. It keeps the architecture of the original (a Go bridge built on whatsmeow plus a Python MCP server) and adds the fixes the original never merged. It needs Go 1.26+, Python 3.11+ and uv. The bridge must keep running in a terminal, or as a launchd service on macOS, for Claude to see new messages.
WhatsApp MCP (original) Most starred
lharries/whatsapp-mcp
The project that started WhatsApp + Claude: 12 tools for searching contacts, listing chats, reading messages and sending text, files and audio.
Key Features
- 12 tools: search_contacts, list_messages, send_message, send_file, download_media and more
- Go bridge on whatsmeow, Python MCP server, local SQLite
- Works with Claude Desktop and Cursor
- Re-scan the QR code about every 20 days
Installation
git clone https://github.com/lharries/whatsapp-mcp.git
cd whatsapp-mcp/whatsapp-bridge && go run main.goMost tutorials still link here, but the last commit was in July 2025. When WhatsApp updates its protocol, the old whatsmeow version fails with "Client outdated (405)". Dozens of issues report it and the fix PRs are unmerged. If you already use it, bump whatsmeow in whatsapp-bridge/go.mod (go get -u go.mau.fi/whatsmeow) or switch to the fork.
WhatsApp Channel for Claude Code Claude Code channel
Rich627/whatsapp-claude-plugin
A community Claude Code channel plugin. Message your running Claude Code session from WhatsApp and it replies from your own number, the same way the official Telegram and Discord channels work.
Key Features
- Incoming WhatsApp messages wake the session instantly
- Linked-device mode (personal number) or official Cloud API mode (business DMs)
- Allowlist of who can talk to the session
- Also runs as a plain MCP server in Codex CLI, Gemini CLI and Cursor
Installation
claude plugin marketplace add Rich627/whatsapp-claude-plugin
claude plugin install whatsapp-channel@whatsapp-claude-plugin
claude --dangerously-load-development-channels plugin:whatsapp-channel@whatsapp-claude-pluginClaude Code channels (research preview since v2.1.80, March 2026) push chat messages into a live session. WhatsApp is not on Anthropic's allowlist, so this plugin needs the development-channels flag. Keep permission prompts on and the allowlist short, and never combine it with --dangerously-skip-permissions: anyone allowed to message the session could then run commands on your machine. Requires Bun.
OpenClaw Agent gateway
openclaw/openclaw
The open-source personal assistant formerly called Clawdbot and Moltbot. It connects WhatsApp, Telegram, Slack and more to the model you choose, including Claude.
Key Features
- WhatsApp via linked device (QR), with pairing or allowlist access
- Runs Claude through an Anthropic API key
- Memory, scheduled tasks, skills and tools
- Self-hosted gateway on your own machine or server
Installation
openclaw onboard --anthropic-api-key "$ANTHROPIC_API_KEY"
openclaw plugins install @openclaw/whatsapp
openclaw channels login --channel whatsapp
openclaw gatewayUse OpenClaw if you want an assistant that lives in WhatsApp and runs around the clock. Claude Code channels only receive messages while a session is open. The docs recommend a separate WhatsApp number. Use an API key: Anthropic's terms reserve Pro and Max subscription logins for Claude Code and Anthropic's own apps. A lighter alternative is NanoClaw, which runs agents in containers on the Claude Agent SDK and adds WhatsApp with one skill.
WhatsApp Business API connectors Official API
composio.dev/toolkits/whatsapp
Hosted MCP servers that call Meta's official WhatsApp Business Cloud API from a verified business number: Composio (58 tools), plus the Bird and LetsBot connectors in Claude's connector directory.
Key Features
- Official API: no linked-device ban risk
- Template messages, media, customer conversations
- Add to Claude.ai or Claude Desktop via Customize → Connectors
- Add to Claude Code with claude mcp add --transport http
Installation
claude mcp add --transport http whatsapp "YOUR_MCP_URL" --header "X-API-Key: YOUR_KEY"Choose this when the WhatsApp number belongs to a business and messages go to customers. You need a Meta Business account, a dedicated number and approved templates for outbound messages, and Meta charges per conversation. It can't read your personal chats. Custom connectors in the Claude apps need a paid Claude plan.
Quick Comparison
| Option | Stars (Oct 2026) | Best for | WhatsApp account | Main risk |
|---|---|---|---|---|
| WhatsApp MCP (fork) | 252 | Read/send your chats from Claude | Personal (linked device) | Unofficial client; prompt injection |
| WhatsApp MCP (original) | >6.6k | Existing setups | Personal (linked device) | Unmaintained, 405 errors |
| Claude Code channel plugin | 110 | Control Claude Code from your phone | Personal or Cloud API | Remote command execution if misconfigured |
| OpenClaw | >390k | Always-on assistant on WhatsApp | Separate number recommended | Unofficial client; broad tool access |
| Business API connectors | Hosted | Customer messaging | Business number | Meta fees and AI policy |
Is There an Official Claude WhatsApp Integration?
No. As of October 2026 Anthropic offers none of these:
- a Claude WhatsApp number or bot
- a first-party WhatsApp connector (the 1,000+ entries in Claude's connector directory include third-party Business API tools like Bird and LetsBot, not a personal WhatsApp connector)
- a WhatsApp channel for Claude Code (the request, anthropics/claude-code#36814, is still open)
The official ways to reach Claude from your phone are:
- The Claude mobile app, including Remote Control (
claude remote-controlor/rc) to drive a Claude Code session running on your computer. - Claude Code channels for Telegram, Discord and iMessage:
/plugin install telegram@claude-plugins-official, thenclaude --channels plugin:telegram@claude-plugins-official. See our Telegram guide and Discord guide. - Dispatch in Claude Cowork, which sends tasks from the Claude app to your desktop.
Set Up the WhatsApp MCP Server Step by Step
These steps install the maintained fork. The original lharries repo uses the same steps, but run go run main.go in the bridge folder instead of go run ..
1. Install the prerequisites
You need Go 1.26+, Python 3.11+ and uv (curl -LsSf https://astral.sh/uv/install.sh | sh). FFmpeg is optional and converts audio into WhatsApp voice notes.
2. Start the bridge and link your phone
git clone https://github.com/verygoodplugins/whatsapp-mcp.git
cd whatsapp-mcp/whatsapp-bridge
go run .
On your phone, open WhatsApp → Settings → Linked Devices → Link a Device and scan the QR code shown in the terminal. Leave the bridge running: it syncs your history into whatsapp-bridge/store/ and receives new messages.
3a. Add it to Claude Code
claude mcp add whatsapp -- uv --directory /absolute/path/to/whatsapp-mcp/whatsapp-mcp-server run main.py
Run /mcp inside Claude Code to check that it's connected.
3b. Or add it to Claude Desktop
Edit ~/Library/Application Support/Claude/claude_desktop_config.json on macOS or %APPDATA%\Claude\claude_desktop_config.json on Windows:
{
"mcpServers": {
"whatsapp": {
"command": "uv",
"args": ["--directory", "/absolute/path/to/whatsapp-mcp/whatsapp-mcp-server", "run", "main.py"]
}
}
}
Restart Claude Desktop. If uv isn't found, put its full path from which uv in command.
4. Try it
- "Summarize what my family group talked about this week."
- "Find the address Maria sent me last month."
- "Draft a reply to the last message from Sam, show it to me, and send it once I approve."
Windows note
The bridge uses go-sqlite3, which needs CGO. Install a C compiler through MSYS2, run go env -w CGO_ENABLED=1, then start the bridge.
Troubleshooting
| Problem | Fix |
|---|---|
Client outdated (405) |
Your whatsmeow version is too old. Switch to the maintained fork, or run go get -u go.mau.fi/whatsmeow && go mod tidy in whatsapp-bridge/. |
| QR code expired or no messages after a few weeks | Linked devices need a fresh scan about every 20 days. Delete whatsapp-bridge/store/ and run the bridge again. |
| Claude shows no WhatsApp tools | Use absolute paths in the config, give the full path to uv, and restart the client. In Claude Code, check /mcp. |
| Messages are missing | The bridge only syncs while it runs. Keep it running, or set it up as a launchd or systemd service. |
| Channel plugin doesn't reply | Start Claude with the --dangerously-load-development-channels flag. Without it the tools load, but incoming messages never wake the session. |
Risks: Account Bans, Prompt Injection and Meta's AI Policy
Unofficial clients. All personal-account options (the MCP servers, the channel plugin in linked-device mode, OpenClaw) log in as a linked device through reverse-engineered libraries (whatsmeow or Baileys). WhatsApp's terms prohibit unofficial clients and automated or bulk messaging. Reading your own chats and sending occasional messages is low-profile use. Mass messaging is how numbers get banned, so use a spare number for anything automated.
Prompt injection. The lharries README warns that a WhatsApp MCP is a "lethal trifecta": Claude can read your private data, receives text from strangers, and can send messages out. A message in a group chat could tell Claude to forward your chats to someone else. Keep tool-approval prompts on for send_message and send_file.
Privacy. The MCP servers store your full message history unencrypted in a local SQLite file. Hosted connectors hold your messages on the vendor's servers.
Meta's AI provider rule. Since 15 January 2026, Section 4.7 of the WhatsApp Business terms bars general-purpose AI assistants from the Business Platform when AI is the main function. That is why ChatGPT's 1-800 WhatsApp number shut down. In June 2026 the European Commission ordered Meta to reopen access in the EU while its investigation runs. A business can still use Claude to answer its own customers, handle bookings or send order updates.
Getting Started
- Pick your goal: read and send your own chats (MCP server), text a running Claude Code session (channel plugin), an always-on assistant (OpenClaw), or customer messaging (Business API connector).
- Use a spare number for anything that sends messages automatically.
- Install with the commands above and link your phone by scanning the QR code under Linked Devices.
- Keep approvals on for every send tool until you trust the setup.
Example prompt: "List the WhatsApp chats where someone asked me a question I haven't answered in the last 3 days, and draft a reply for each."
Related Guides
Frequently Asked Questions
Can I use Claude on WhatsApp?
Not through an official channel. Anthropic doesn't run a Claude WhatsApp number, and Claude Code's official channels are Telegram, Discord and iMessage. To talk to Claude from WhatsApp, run a gateway such as OpenClaw with an Anthropic API key, or install the community WhatsApp channel plugin for Claude Code.
Can Claude read my WhatsApp messages?
Yes, with a WhatsApp MCP server. verygoodplugins/whatsapp-mcp, a maintained fork of lharries/whatsapp-mcp, links your account as a device, stores messages in a local SQLite database, and lets Claude search chats, read history and send messages when you ask.
Is WhatsApp MCP safe? Will my account get banned?
It runs locally, so your messages only go to Claude when a tool is called. It uses an unofficial WhatsApp Web protocol, though, and WhatsApp's terms prohibit unofficial clients and automated messaging. Light personal use is low risk. Bulk or automated sending can get a number banned. Prompt injection is the other risk: a message from someone else can try to steer Claude, so keep approval prompts on for sending.
How do I fix the 'Client outdated (405)' error in WhatsApp MCP?
The error means the bridge's whatsmeow library is older than WhatsApp's current protocol. The original lharries repo hasn't been updated since July 2025. Switch to the maintained verygoodplugins fork, or run 'go get -u go.mau.fi/whatsmeow && go mod tidy' inside whatsapp-bridge and restart.
Can I control Claude Code from WhatsApp?
Yes, with the community plugin Rich627/whatsapp-claude-plugin. Install it with 'claude plugin marketplace add Rich627/whatsapp-claude-plugin' and start Claude with '--dangerously-load-development-channels plugin:whatsapp-channel@whatsapp-claude-plugin'. WhatsApp isn't on Anthropic's channel allowlist yet. The official alternatives are Telegram, Discord, iMessage and Remote Control in the Claude app.
Does WhatsApp MCP work with the free Claude plan?
Local MCP servers, configured in claude_desktop_config.json, work in Claude Desktop on any plan and in Claude Code. Remote custom connectors added under Customize → Connectors on Claude.ai require a paid plan.
Can I use my Claude Pro or Max subscription with OpenClaw?
Use an Anthropic API key. Anthropic's terms say subscription OAuth logins are meant for Claude Code and Anthropic's own apps, and that third-party tools shouldn't route requests through Free, Pro or Max credentials. OpenClaw's own docs recommend an API key for new setups.
Can I build a Claude chatbot on the WhatsApp Business API?
Yes, if it serves your business's own customers: support, bookings, order updates. Since 15 January 2026, Meta's terms bar general-purpose AI assistants from the Business Platform when AI is the product itself. In the EU, the European Commission ordered Meta in June 2026 to restore access while its investigation runs.
