WhatsApp Claude Plugin
About
WhatsApp channel plugin for Claude Code. Connect WhatsApp as a native channel to your Claude Code session — send/receive messages, voice transcription, access control, and remote tool approval. No API keys needed, uses Baileys for WhatsApp Web connectivity.
Details
- Author
- rich627
- Categories
- Productivity, Other, AI, Communication
Jump to
Setup
Install WhatsApp Claude Plugin in your MCP client (Claude Desktop, Cursor, Windsurf, and others).
Repository: https://github.com/rich627/whatsapp-claude-plugin
Follow the installation instructions in the repository README, then restart your MCP client.
Drive your Claude Code session from WhatsApp — your personal number, no bots, no API keys.
The plugin connects to WhatsApp as alinked device(the same protocol as WhatsApp Web, via Baileys) and exposes it to Claude Code as an MCP channel. Incoming messages reach your session in real time; Claude replies from your own number, so recipients see a normal chat. Everything runs locally on your machine — messages travel directly between WhatsApp and your session, with no third-party servers in between. Once paired, it keeps working while your phone is off; only the Claude Code session needs to stay open, and reconnects never require re-pairing.
Published on theAnthropic Official Plugin Marketplace— the first community-built WhatsApp channel plugin reviewed and published by Anthropic.
claude plugin marketplace add Rich627/whatsapp-claude-plugin claude plugin install whatsapp-claude-channel@whatsapp-claude-plugin claude --dangerously-load-development-channels plugin:whatsapp-claude-channel@whatsapp-claude-plugin
The--dangerously-load-development-channelsflag matters: it registers the plugin as achannel, so an inbound WhatsApp message wakes your session immediately. Without it the tools still load, but nothing wakes the session when messages arrive — they sit unanswered until you (or awatchdog) prompt Claude to check.--channelsdoes not accept this plugin yet (it is not on the research-preview allowlist), so the development flag is currently the only way.
Inside the session, set your number and pair:
/whatsapp-claude-channel:configure <phone> # country code + number, no +
A pairing code is printed on first launch. On your phone: WhatsApp → Settings → Linked Devices → Link a Device →Link with phone number instead→ enter the code. No WhatsApp Business API, Meta developer account, or API key is involved — it links to your regular account.
- Bidirectional messaging.Send and receive from the session; long replies are chunked to WhatsApp's limits or sent as a document attachment past a configurable threshold.
- @-mentions.replycan tag people so they actually get notified — ids are accepted as phone, LID, or full JID, and mentions attach only to the chunk that names them.
- Full media support.Photos, voice notes, video, documents, and stickers, in both directions.
- Voice transcription.Incoming voice notes are transcribed locally via mlx-whisper (seesetup); without the script they arrive as plain attachments.
- Access control.Pairing codes, allowlists, and per-group policies gate every inbound message — strangers never reach your session. Managed via/whatsapp-claude-channel:access.
- Per-group personalities.Each group gets its ownconfig.mdwith a custom personality and conversation memory.
- Permission relay.Approve or deny Claude's tool requests from WhatsApp with an emoji reaction (👍 / 👎).
- Cron tasks.A## Cron Jobssection in a group'sconfig.mdschedules recurring server-side tasks.
- Context recovery.After a restart, thecatch_uptool replays recent two-way conversation per chat, unreplied counts, and open tasks fromtasks.md, so a fresh session resumes mid-flight work.
- Dual accounts.Run personal and business numbers side by side with separate state and behaviors.
- Self-diagnosis./whatsapp-claude-channel:doctorchecks the server process, device link, singleton lock, and config, then walks you through the fixes — no more guessing why replies stopped.
WhatsApp (phone) <──Baileys──> MCP Server <──stdio──> Claude Code
The server (a single Bun process) holds the linked-device connection and forwards inbound messages to the session as channel notifications after they pass the access gate. Claude acts through MCP tools —reply,react,edit_message,download_attachment,status,unreplied,catch_up,list_groups. Runtime state (auth, allowlists, group configs, inbox) lives in~/.whatsapp-channel/, never in the repo.
Messages sent by Claude appear as coming from your phone number. Use a dedicated number if you want a distinct bot identity.
One-time setup (Apple Silicon, mlx-whisper):
brew install ffmpeg # mlx-whisper uses it to decode audio python3 -m venv ~/whisper-env source ~/whisper-env/bin/activate pip install mlx-whisper cp scripts/whisper-transcribe.sh ~/whisper-transcribe.sh chmod +x ~/whisper-transcribe.sh ~/whisper-transcribe.sh path/to/sample.ogg # optional: test
The reference script usesmlx-community/whisper-large-v3-turbo— accurate, fast, multilingual. Swap the model in the script if you prefer a smaller one.
Full documentation lives inUSAGE.md:access control, thetools exposed to the assistant,dual-account setup,session conflicts, andresetting auth.
Issues and pull requests are welcome — readCONTRIBUTING.mdbefore opening one. Report security issues privately perSECURITY.md.
Secure audio transcription meets AI. Connect Alice recordings to Claude, ChatGPT, Gemini, and more.
A bridge server connecting Claude Desktop with the chakoshi moderation API for content safety.
Local-first MCP server that puts your own LINE and Telegram chats behind one data layer — a daemon on your machine logs in with your own account, stores messages to JSONL + SQLite/FTS5, and exposes them to MCP clients like Claude Code. Not an npx one-liner: you clone the repo and run the daemon yourself.
Sends notifications from Claude Code with customizable sounds and cross-platform support.
A high-performance trading system for Claude Desktop, providing real-time market data via Tiingo and optional Telegram alerts.
Connect Restream MCP to Claude or ChatGPT to create, schedule, manage, and analyze live streams across 30+ platforms.
Let Claude book a real restaurant table for you - an AI voice agent places the actual phone call, even to restaurants that only take reservations by phone.
Persistent memory for any AI assistant. Zero token cost until recall. Stores memories in local SQLite, ranks by 6-factor scoring, returns results 79% smaller than JSON. Works with Claude, ChatGPT, Grok, Cursor, Windsurf, and any MCP client.
Transform your scattered documentation into AI-ready knowledge that works seamlessly with Claude, Cursor, VS Code, and other AI tools.
Plug your AI agent into OpenCharts—build spreadsheets, boards, music, and automations from Claude Code, Codex, or Cursor without leaving your terminal.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
