WhatsApp Claude Plugin
Claude Code WhatsApp channel plugin — run AI directly from WhatsApp, voice transcription, remote tool approval, access control. No API keys, no Docker, just a linked device.
What is WhatsApp Claude Plugin?
WhatsApp Claude Plugin is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to claude code whatsapp channel plugin — run ai directly from whatsapp, voice transcription, remote tool approval, access control. no api keys, no docker, just a linked device.
Claude Code WhatsApp channel plugin — run AI directly from WhatsApp, voice transcription, remote tool approval, access control. No API keys, no Docker, just a linked device.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Claude Code WhatsApp channel plugin — run AI directly from W
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx whatsapp-claude-pluginConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use WhatsApp Claude Plugin
The WhatsApp Claude Plugin is a Claude Code channel plugin written in TypeScript that connects your existing WhatsApp account (as a linked device via the Baileys library) to Claude Code sessions — no API keys, no Business Account, and no Docker required. It supports bidirectional messaging, media handling (photos, videos, documents, stickers), voice message transcription via mlx-whisper, per-group personality customization, remote tool approval via WhatsApp, scheduled automation with cron tasks, and dual-account management for personal and bot use.
Prerequisites
- Claude Code CLI installed (npm install -g @anthropic-ai/claude-code)
- Node.js 18+ installed
- An active WhatsApp account on your phone
- Optional: ffmpeg and mlx-whisper for voice message transcription
Install the plugin via the Claude plugin marketplace
Install the WhatsApp Claude Plugin directly through the Claude Code plugin marketplace.
claude plugin marketplace add Rich627/whatsapp-claude-plugin
claude plugin install whatsapp-claude-channel@whatsapp-claude-pluginConfigure your WhatsApp phone number
After installation, configure the plugin with your WhatsApp phone number (with country code). This registers the linked device connection.
# Inside a Claude Code session:
/whatsapp-claude-channel:configure +1234567890Scan the QR code to link WhatsApp
The plugin will display a QR code in the terminal. Open WhatsApp on your phone, go to Settings → Linked Devices → Link a Device, and scan the QR code. The connection is established without sharing your password.
# Start Claude Code — the plugin will display the QR code
claude
# On your phone:
# WhatsApp → Settings → Linked Devices → Link a Device → Scan QROptional: Set up voice transcription
For voice message transcription support, install ffmpeg and mlx-whisper. This enables audio messages received on WhatsApp to be automatically transcribed before being passed to Claude.
# macOS
brew install ffmpeg
pip install mlx-whisper
# Linux
sudo apt install ffmpeg
pip install mlx-whisperSend a message to Claude via WhatsApp
Once linked, send any message to yourself or a configured contact/group on WhatsApp. Claude will receive it, process it, and reply through WhatsApp. Available MCP tools include reply, react, edit_message, and download_attachment.
# MCP tools available in Claude Code sessions:
# reply - Send a WhatsApp message reply
# react - Add a reaction emoji to a message
# edit_message - Edit a previously sent message
# download_attachment - Download a media attachment from a messageWhatsApp Claude Plugin Examples
Client configuration
The plugin integrates directly with Claude Code and does not require a separate MCP server config block. Configure it through the plugin system after installation.
{
"mcpServers": {
"whatsapp-claude-channel": {
"command": "claude",
"args": ["plugin", "run", "whatsapp-claude-channel"],
"env": {
"WHATSAPP_PHONE": "+1234567890"
}
}
}
}Prompts to try
Things you can say or do via WhatsApp once connected to Claude Code.
- Send "What files are in my project?" via WhatsApp to have Claude list your working directory
- Send a voice message asking Claude to explain a piece of code (transcribed automatically)
- Send a photo of a UI mockup and ask Claude to generate the corresponding HTML
- Send "Run the tests and tell me if they pass" for remote development workflows
- Set up per-group personality: configure different Claude personas for different WhatsApp groupsTroubleshooting WhatsApp Claude Plugin
QR code expires before scanning
QR codes for WhatsApp linked devices expire after about 20 seconds. If you miss the window, restart the plugin to generate a fresh QR code. Keep your phone's WhatsApp app open and ready on the Linked Devices screen before starting Claude.
Voice messages are not being transcribed
Ensure both ffmpeg and mlx-whisper are installed and accessible in the PATH used by the plugin. Run 'ffmpeg -version' and 'python -c "import mlx_whisper"' to verify. On Apple Silicon Macs, mlx-whisper uses the Neural Engine for fast local transcription.
Messages stop arriving after some time
WhatsApp linked device sessions can expire or disconnect if the phone loses internet connectivity for an extended period. Re-run the configuration command to initiate a new QR code scan and re-link the device. WhatsApp allows up to 4 linked devices simultaneously.
Frequently Asked Questions about WhatsApp Claude Plugin
What is WhatsApp Claude Plugin?
WhatsApp Claude Plugin is a Model Context Protocol (MCP) server that claude code whatsapp channel plugin — run ai directly from whatsapp, voice transcription, remote tool approval, access control. no api keys, no docker, just a linked device. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install WhatsApp Claude Plugin?
Follow the installation instructions on the WhatsApp Claude Plugin GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with WhatsApp Claude Plugin?
WhatsApp Claude Plugin works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is WhatsApp Claude Plugin free to use?
Yes, WhatsApp Claude Plugin is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
WhatsApp Claude Plugin Alternatives — Similar Communication Servers
Looking for alternatives to WhatsApp Claude Plugin? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up WhatsApp Claude Plugin in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use WhatsApp Claude Plugin?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.