Install WhatsApp MCP for Claude Desktop
Claude Desktop reads mcpServers from claude_desktop_config.json. Restart the app after saving.
- Open ~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows, or ~/.config/Claude/claude_desktop_config.json on Linux.
- Paste the JSON config below.
- Replace placeholder secrets, then restart the client if it does not reload on its own.
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"adelaidasofia-whatsapp-mcp": {
"command": "uvx",
"args": [
"adelaidasofia-whatsapp-mcp"
],
"env": {
"WHATSAPP_BRIDGE_HOST": "127.0.0.1",
"WHATSAPP_BRIDGE_PORT": "8080",
"WHATSAPP_VAULT_CRM_PATH": "",
"WHATSAPP_WHISPER_BACKEND": "local-cpp",
"WHATSAPP_WHISPER_API_KEY": "YOUR_WHATSAPP_WHISPER_API_KEY",
"WHATSAPP_WHISPER_MODEL": "large-v3",
"WHATSAPP_SCRUB_PROMPT_INJECTION": "true",
"WHATSAPP_AUDIT_LOG": "true",
"WHATSAPP_ENCRYPT_DB": "true"
}
}
}
}