# WhatsApp MCP Connect Claude Code to WhatsApp chats, contacts, and messages. The server supports local voice-note transcription and a confirmation step before sending. - MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 6 - Author: adelaidasofia - License: MIT · policy=link-only · description only; the file stays with the author - Source: https://github.com/adelaidasofia/whatsapp-mcp - Updated: 2026-10-22 - HTML: https://affpapa.org/en/nevibecode/mcp/whatsapp-mcp ## What it does WhatsApp MCP lets an agent read chats, messages, and contacts, then search message history with typo- and accent-tolerant matching. It can resolve LID names, attach matching CRM context from an Obsidian vault, and transcribe voice notes on the same machine with `whisper.cpp`. The setup has two local parts: the Go `whatsapp-bridge/` and the Python `whatsapp-mcp-server/` built with FastMCP. The bridge uses `whatsmeow`, keeps data in an encrypted SQLCipher database, and exposes a REST API to the Python layer. Outbound text, reactions, and quoted replies stay behind a draft plus mandatory `confirm_send` step; tool calls go to an audit log. The bridge needs a one-time QR pairing with your phone before it can connect to WhatsApp. That pairing is a prerequisite, not an optional setup detail. Voice transcription needs FFmpeg and `whisper.cpp`; choosing `openai-api` also requires `WHATSAPP_WHISPER_API_KEY`. ## Requirements - Needs: Python and uv (commands run via uvx) - Environment variables: `WHATSAPP_BRIDGE_HOST`, `WHATSAPP_BRIDGE_PORT`, `WHATSAPP_VAULT_CRM_PATH`, `WHATSAPP_WHISPER_BACKEND`, `WHATSAPP_WHISPER_API_KEY`, `WHATSAPP_WHISPER_MODEL`, `WHATSAPP_SCRUB_PROMPT_INJECTION`, `WHATSAPP_AUDIT_LOG`, `WHATSAPP_ENCRYPT_DB` — keys and tokens: ask the human for the values, never commit them or put them in shared files. ## Install ### Claude Code (native platform) **Platform CLI** ```bash claude mcp add --env WHATSAPP_BRIDGE_HOST= --env WHATSAPP_BRIDGE_PORT= --env WHATSAPP_VAULT_CRM_PATH= --env WHATSAPP_WHISPER_BACKEND= --env WHATSAPP_WHISPER_API_KEY= --transport stdio whatsapp-mcp -- uvx adelaidasofia-whatsapp-mcp ``` Replace <…> with your own values. 4 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from adelaidasofia-whatsapp-mcp ### Codex **Platform CLI** ```bash codex mcp add whatsapp-mcp --env WHATSAPP_BRIDGE_HOST= --env WHATSAPP_BRIDGE_PORT= --env WHATSAPP_VAULT_CRM_PATH= --env WHATSAPP_WHISPER_BACKEND= --env WHATSAPP_WHISPER_API_KEY= -- uvx adelaidasofia-whatsapp-mcp ``` Replace <…> with your own values. 4 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from adelaidasofia-whatsapp-mcp ### Cursor **Config file** File `.cursor/mcp.json`: ```json { "mcpServers": { "whatsapp-mcp": { "command": "uvx", "args": [ "adelaidasofia-whatsapp-mcp" ], "env": { "WHATSAPP_BRIDGE_HOST": "", "WHATSAPP_BRIDGE_PORT": "", "WHATSAPP_VAULT_CRM_PATH": "", "WHATSAPP_WHISPER_BACKEND": "", "WHATSAPP_WHISPER_API_KEY": "" } } } } ``` Replace <…> with your own values. 4 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from adelaidasofia-whatsapp-mcp ### GitHub Copilot **Config file** File `.vscode/mcp.json`: ```json { "servers": { "whatsapp-mcp": { "type": "stdio", "command": "uvx", "args": [ "adelaidasofia-whatsapp-mcp" ], "env": { "WHATSAPP_BRIDGE_HOST": "", "WHATSAPP_BRIDGE_PORT": "", "WHATSAPP_VAULT_CRM_PATH": "", "WHATSAPP_WHISPER_BACKEND": "", "WHATSAPP_WHISPER_API_KEY": "" } } } } ``` Replace <…> with your own values. 4 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from adelaidasofia-whatsapp-mcp ### Gemini CLI **Platform CLI** ```bash gemini mcp add -e WHATSAPP_BRIDGE_HOST= -e WHATSAPP_BRIDGE_PORT= -e WHATSAPP_VAULT_CRM_PATH= -e WHATSAPP_WHISPER_BACKEND= -e WHATSAPP_WHISPER_API_KEY= whatsapp-mcp uvx adelaidasofia-whatsapp-mcp ``` Replace <…> with your own values. 4 more environment variables are in the server README. uvx runs the command named after the package; if the README names another one, use uvx --from adelaidasofia-whatsapp-mcp ## When to use it - read WhatsApp chats and contacts from an agent - search messages despite accents or typos - transcribe voice notes on the local machine - draft a reply before it is sent - bring Obsidian CRM context into chat work ## Example prompts - Search WhatsApp for messages about the release, allowing for typos and accents. - Show the latest messages in this chat and include matching CRM context from the Obsidian vault. - Draft a reply to the latest message, show it to me, and send it only after `confirm_send`. ## Similar - [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16730 - [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40459 - [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24271 - [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18779 - [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9369 - [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7548 --- NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md