WACrew — WhatsApp MCP server for Claude Code: install
WACrew · WhatsApp MCP server is an MCP server for Claude Code that searches WhatsApp chats and groups, drafts or sends replies, transcribes voice notes, and inspects files.
Apache-2.0 ★ 10 updated 2026-11-16
claude mcp add wacrew-whatsapp-mcp -e WAC_CLOUD_URL=<WAC_CLOUD_URL> -e WAC_CLOUD_USER=<WAC_CLOUD_USER> -e WAC_CLOUD_PASS=<WAC_CLOUD_PASS> -- npx -y wacrew-mcpWhat WACrew · WhatsApp MCP server does
WACrew exposes tools for reading and searching WhatsApp conversations, preparing replies, and managing sends. Voice notes can be transcribed; images, videos, and PDFs can be examined. The tool set also includes message review and cancellation.
A running WACrew panel is required to connect to WhatsApp. The panel runs with Docker, while the MCP receives its URL and login through WAC_CLOUD_URL, WAC_CLOUD_USER, and WAC_CLOUD_PASS. Install the MCP with npx -y wacrew-mcp.
By default, the agent presents a reply and waits for approval before sending; chats can use autonomo mode instead. WACrew connects through Baileys rather than WhatsApp’s official API. It is intended for conversations with people who already message the account, not bulk messaging.
What it helps with
- Search a WhatsApp conversation for a specific message
- Summarize the day’s chats
- Transcribe a voice note
- Read a PDF shared in a chat
- Draft a reply and send it after approval
Example prompts for the agent
- Find the latest WhatsApp messages about the delivery date and summarize them.
- Transcribe the voice note in the work group.
- Draft a reply in this chat, show it to me, then send it after I approve.
How to install WACrew · WhatsApp MCP server
Platform CLI
claude mcp add wacrew-whatsapp-mcp -e WAC_CLOUD_URL=<WAC_CLOUD_URL> -e WAC_CLOUD_USER=<WAC_CLOUD_USER> -e WAC_CLOUD_PASS=<WAC_CLOUD_PASS> -- npx -y wacrew-mcpReplace <…> with your own values
Platform CLI
codex mcp add mcp --env WAC_CLOUD_URL=<WAC_CLOUD_URL> --env WAC_CLOUD_USER=<WAC_CLOUD_USER> --env WAC_CLOUD_PASS=<WAC_CLOUD_PASS> -- npx -y wacrew-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"wacrew-mcp"
],
"env": {
"WAC_CLOUD_URL": "<WAC_CLOUD_URL>",
"WAC_CLOUD_USER": "<WAC_CLOUD_USER>",
"WAC_CLOUD_PASS": "<WAC_CLOUD_PASS>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"wacrew-mcp"
],
"env": {
"WAC_CLOUD_URL": "<WAC_CLOUD_URL>",
"WAC_CLOUD_USER": "<WAC_CLOUD_USER>",
"WAC_CLOUD_PASS": "<WAC_CLOUD_PASS>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e WAC_CLOUD_URL=<WAC_CLOUD_URL> -e WAC_CLOUD_USER=<WAC_CLOUD_USER> -e WAC_CLOUD_PASS=<WAC_CLOUD_PASS> mcp npx -y wacrew-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about WACrew · WhatsApp MCP server
How do I install WACrew in Claude Code?
Run `claude mcp add wacrew-whatsapp-mcp -e WAC_CLOUD_URL=<WAC_CLOUD_URL> -e WAC_CLOUD_USER=<WAC_CLOUD_USER> -e WAC_CLOUD_PASS=<WAC_CLOUD_PASS> -- npx -y wacrew-mcp`. A running WACrew panel with matching credentials is also required.
What does WACrew do?
It gives an agent tools to read and search WhatsApp chats, transcribe voice notes, inspect images and videos, and read PDFs. The agent can prepare replies and send them after approval by default.
What does WACrew need to run?
It needs a running WACrew panel connected to WhatsApp; the panel can be launched with Docker. The MCP needs the panel URL and login credentials, and WhatsApp must be connected by scanning a QR code.