WhatsApp Channel for Claude Code plugin
A Claude Code plugin with a WhatsApp channel: the session replies from your number or through the official Cloud API
- 119 ★ on the repository
- Last commit
- Apache-2.0
Broad access
Why this level
- The plugin feeds other people's messages straight into the agent session, and the linked-device connection may break WhatsApp rules and risk a number ban
- The agent sends messages from your number and can request tool actions
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/whatsapp-channel-for-claude-codeDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The plugin feeds other people's messages straight into the agent session, and the linked-device connection may break WhatsApp rules and risk a number ban
- The agent sends messages from your number and can request tool actions
This is third-party code. Review the repository files before installing.
What it does
WhatsApp Channel for Claude Code connects a Claude Code session to WhatsApp. An incoming message wakes the session immediately, and Claude replies from your number or a business number. There are two connections. The linked device, `baileys`, is the default: you pair your phone as with WhatsApp Web and need no Meta keys. The official `cloud-api` uses Meta's business API and a public HTTPS webhook with separate credentials. In this implementation it handles direct messages only and carries Meta's fees and policies. A Bun server provides the tools `reply`, `react`, `download_attachment`, `status`, `unreplied` and `catch_up`. It chunks long replies, shows a typing indicator, supports mentions, photos, voice notes, video, documents and stickers, polls of up to 12 options, local voice transcription through mlx-whisper, a per-group `config.md` with personality and memory, scheduled tasks and approving tool requests with a reaction. Access is closed by a gate: pairing codes, allowlists and per-group policies keep strangers away from the session. Other people's messages reach your session, so keep the trusted circle small.
Who it is for. Developers who want to drive a Claude Code session from WhatsApp and accept the limits of an unofficial protocol.
Good fit when
- Claude Code answers messages from your phone on the go and the outcome arrives in WhatsApp
- A team group gets the agent's replies, each group with its own personality and memory settings
- Claude's tool request is approved or denied with a reaction on a message
- After a restart the session shows how many messages wait per chat and resumes where it stopped
Not a fit when
- You need an official, safe channel with no number risk: the linked-device protocol is unofficial and may conflict with WhatsApp rules
- You need groups over Cloud API: this implementation supports direct messages only
- The agent has to run without Bun or in a client that does not push inbound messages: outside Claude Code you must poll with `wait_for_messages`
Example request
Run /whatsapp-channel:setup and connect the linked device, then show the access policy with /whatsapp-channel:access.Limitations
The plugin is not made by Anthropic or Meta. The `baileys` provider uses an unofficial linked-device protocol, which may violate WhatsApp rules and put the number at risk of a ban. Cloud API needs a Meta business number, a token, an app secret and a public webhook address, plus Meta fees and policies. It loads with the `--dangerously-load-development-channels` flag, and Claude Code warns that such a channel puts other people's text straight into the session. Read the plugin code, keep permission prompts on and narrow the trusted circle. Only one client holds a state directory at a time.
How to disable. Remove the whatsapp-channel plugin through /plugin and end the session. In WhatsApp unlink the device under Linked Devices. Delete the ~/.whatsapp-channel directory with state and keys by hand.
FAQ
How do I install the plugin?
Run `claude plugin marketplace add Rich627/whatsapp-claude-plugin` and `claude plugin install whatsapp-channel@whatsapp-claude-plugin`, then start Claude Code with `--dangerously-load-development-channels plugin:whatsapp-channel@whatsapp-claude-plugin`.
Why the dangerous flag?
It registers the plugin as a channel so an inbound message wakes the session at once. Without it the tools still load but messages wait until you ask Claude to check. The `--channels` flag does not accept this plugin yet.
How do I link a number?
Run `/whatsapp-channel:configure <number>` with country code and no plus. Enter the printed code in WhatsApp, Linked Devices, Link with phone number, or scan the QR. For Cloud API the wizard runs in your terminal so keys never pass through chat.
How do I keep strangers out?
The gate lets in only listed people: use `/whatsapp-channel:access` or `bun scripts/access.ts policy pairing`. Approving a pairing needs the specific code, because "approve the pending one" looks like a prompt injection.
Does it work in Codex, Gemini CLI and Cursor?
Yes as a plain stdio MCP server through Bun, but inbound messages are not pushed, as that is a Claude Code extension. Other clients poll `wait_for_messages`, and access setup uses `bun scripts/access.ts`.
Discussion
No questions or reviews yet.
Related
PluginsClaude Code interviews you about your business, then writes, tests and deploys a WhatsApp bot with per-customer memory
A plugin gives Claude Code OpenBSP API access and WhatsApp replies, forwarding channel messages only from selected contacts.
An MCP channel that passes WeChat messages into a Claude Code session and sends the agent's replies back to the same chat
Upgrade for the official Claude Code Telegram plugin: voice messages, live progress, buttons, memory and an agents board
A plugin that makes Claude Code a background assistant: scheduled tasks, Telegram, Discord and Slack replies, a web dashboard.
A Telegram bot drives Claude Code on your computer: you message the chat and the agent edits the project and streams the reply.
README in short
The README explains how to connect a Claude Code session to WhatsApp two ways: a linked device or the official Cloud API. It describes warnings about the unofficial protocol and the dangerous flag, installation, choosing a connection, use in other MCP clients, access control from a terminal, features, voice transcription, diagnostics and the Apache-2.0 license.