All How-To Guides

How to Use WhatsApp with Claude (2026): 5 Ways That Work

How do I connect WhatsApp to Claude or Claude Code?

5 ways compared, stars checked Oct 2026

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.
Webfuse Live demo · no signup

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.

No signup Runs in this page Take over any time
Start free demo
Start the free Webfuse demo

The 5 Ways to Connect WhatsApp and Claude

WhatsApp MCP (maintained fork) Best MCP

verygoodplugins/whatsapp-mcp

>200

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.py

This 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.

Best for: Personal WhatsApp in Claude Desktop or Claude Code View on GitHub

WhatsApp MCP (original) Most starred

lharries/whatsapp-mcp

>7k

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.go

Most 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.

Best for: Reference; use the maintained fork for new setups View on GitHub

WhatsApp Channel for Claude Code Claude Code channel

Rich627/whatsapp-claude-plugin

>100

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-plugin

Claude 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.

Best for: Driving Claude Code from your phone View on GitHub

OpenClaw Agent gateway

openclaw/openclaw

>392k

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 gateway

Use 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.

Best for: A Claude-powered assistant you text on WhatsApp View on GitHub

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.

Best for: Customer messaging, support, notifications Composio WhatsApp toolkit

Quick Comparison

OptionStars (Oct 2026)Best forWhatsApp accountMain risk
WhatsApp MCP (fork)252Read/send your chats from ClaudePersonal (linked device)Unofficial client; prompt injection
WhatsApp MCP (original)>6.6kExisting setupsPersonal (linked device)Unmaintained, 405 errors
Claude Code channel plugin110Control Claude Code from your phonePersonal or Cloud APIRemote command execution if misconfigured
OpenClaw>390kAlways-on assistant on WhatsAppSeparate number recommendedUnofficial client; broad tool access
Business API connectorsHostedCustomer messagingBusiness numberMeta 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-control or /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, then claude --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

  1. 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).
  2. Use a spare number for anything that sends messages automatically.
  3. Install with the commands above and link your phone by scanning the QR code under Linked Devices.
  4. 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.

Keep Exploring

WebMCP Developers