WhatsApp MCP Server for Claude Code: Run AI Directly from WhatsApp
Published on the Anthropic Official Plugin Marketplace — the first community-built WhatsApp channel plugin to be officially reviewed and published by Anthropic.
Connect WhatsApp as a native channel to your Claude Code session using this MCP server plugin. Automate tasks, execute code, search files, and interact with Claude AI directly from WhatsApp messaging—no bots, no API keys, just your personal WhatsApp account connected as a linked device. Built on Baileys for reliable WhatsApp Web connectivity.
Key Features
- Bidirectional messaging — send and receive WhatsApp messages directly from your Claude Code session
- Full media support — photos, voice notes, video, documents, and stickers
- Automatic voice transcription — voice messages transcribed with mlx-whisper
- Access control — allowlists, pairing codes, and group policies to control who can interact
- Per-group personalities — customize Claude's behavior for each WhatsApp group
- Permission relay — approve or deny Claude's tool requests remotely from WhatsApp
- Scheduled cron tasks — set up recurring automated tasks via server-side cron engine
- Dual-account setup — run personal and bot accounts simultaneously
Quick Start
# 1. Add this marketplace (one-time)
claude plugin marketplace add Rich627/whatsapp-claude-plugin
# 2. Install the plugin
claude plugin install whatsapp@whatsapp-claude-plugin
# 3. Launch Claude Code — the plugin loads automatically
claude
Inside the session, configure your phone number and pair:
/whatsapp:configure <phone> # country code + number, no +
On first launch, a pairing code is printed to your terminal. On your phone: WhatsApp > Settings > Linked Devices > Link a Device > Link with phone number instead > enter the code.
How It Works
WhatsApp (phone) <──Baileys──> MCP Server <──stdio──> Claude Code
- The MCP server connects to WhatsApp as a linked device using the Baileys library (same protocol as WhatsApp Web)
- Incoming messages are forwarded to your Claude Code session as channel notifications
- Claude responds using MCP tools (
reply, react, edit_message, download_attachment)
- Access control ensures only allowlisted contacts can interact
Messages sent by Claude appear as coming from your phone number. Use a dedicated number if you need a separate bot identity.
Use Cases
- Personal AI assistant — message Claude from anywhere via WhatsApp, get answers, run code, and manage tasks on the go
- Team support bot — add Claude to a WhatsApp group with custom personality and let it help your team
- Remote development — approve Claude's tool requests and monitor progress from WhatsApp when away from your desk
- Automated notifications — use cron tasks to send scheduled reports or reminders through WhatsApp
- Multi-account management — run separate personal and business WhatsApp accounts with different Claude behaviors
FAQ
Q: Do I need a WhatsApp Business API account?
A: No. This plugin connects as a linked device to your regular WhatsApp account—no Business API, no Meta developer account, no API keys needed.
Q: Can people tell it's AI responding?
A: No, messages come from your phone number. Recipients see no difference. Use a separate number if you want a distinct bot identity.
Q: Does it work when my phone is off?
A: Yes. WhatsApp linked devices work independently once paired. Your Claude Code session must stay open though.
Q: Is my data sent to third parties?
A: No. The MCP server runs locally on your machine. Messages go directly between WhatsApp and your local Claude Code session.
Q: What happens if Claude Code disconnects?
A: The WhatsApp session disconnects too. Just relaunch—no re-pairing needed, auth is saved locally.
Troubleshooting