WhatsApp MCP
CommunityMCP server by adelaidasofia · updated · ★ 5
WhatsApp MCP. SQLCipher-encrypted, scrubber-CI-gated, draft-and-confirm sends, voice transcription. WhatsApp MCP is a community project by adelaidasofia, not verified by a company domain.
Install WhatsApp MCP
Built from the published package, never by AIclaude mcp add whatsapp-mcp -- uvx adelaidasofia-whatsapp-mcpRun in your terminal. Add --scope user to use it in every project.
{
"mcpServers": {
"whatsapp-mcp": {
"command": "uvx",
"args": [
"adelaidasofia-whatsapp-mcp"
]
}
}
}Settings, Developer, Edit config. Paste into claude_desktop_config.json and restart.
{
"mcpServers": {
"whatsapp-mcp": {
"command": "uvx",
"args": [
"adelaidasofia-whatsapp-mcp"
]
}
}
}Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project).
{
"servers": {
"whatsapp-mcp": {
"command": "uvx",
"args": [
"adelaidasofia-whatsapp-mcp"
]
}
}
}Add to .vscode/mcp.json. VS Code uses "servers", not "mcpServers".
codex mcp add whatsapp-mcp -- uvx adelaidasofia-whatsapp-mcp{
"mcpServers": {
"whatsapp-mcp": {
"command": "uvx",
"args": [
"adelaidasofia-whatsapp-mcp"
]
}
}
}Add to ~/.gemini/config/mcp_config.json (all projects) or .agents/mcp_config.json (this project).
gemini mcp add whatsapp-mcp uvx adelaidasofia-whatsapp-mcpGemini CLI was replaced by Antigravity CLI in June 2026 and remains only for enterprise licences and paid API keys.
MCP servers run with your permissions and can read what you give them access to. Some need an API key: check the README and add it under env in the whatsapp-mcp block.
Last commit 8 days ago
MIT: permissive, fine for commercial use
Clear description, published package or server URL, original repository
Not checked yet. What we check
What you need
| Setting | Needed | What it is |
|---|---|---|
WHATSAPP_Environment variable | Optional | Hostname for the Go bridge REST API. Default: 127.0.0.1 |
WHATSAPP_Environment variable | Optional | Port for the Go bridge REST API. Default: 8080 |
WHATSAPP_Environment variable | Optional | Absolute path to a vault CRM folder for auto-injection (e.g., Obsidian 'CRM/'). When unset, CRM injection is disabled. |
WHATSAPP_Environment variable | Optional | Voice-note transcription backend. 'local-cpp' (default, private) or 'openai-api' (opt-in). Default: local-cpp |
WHATSAPP_Environment variable, secret | Optional | OpenAI API key. Required only when WHATSAPP_WHISPER_BACKEND=openai-api. |
WHATSAPP_Environment variable | Optional | whisper.cpp model name. Only used when backend is local-cpp. Default: large-v3 |
WHATSAPP_Environment variable | Optional | Strip known prompt-injection patterns from incoming messages before the LLM sees them. Default: true |
WHATSAPP_Environment variable | Optional | Log every tool call to audit.log. Default: true |
WHATSAPP_Environment variable | Optional | Enable SQLCipher DB encryption with the key sourced from macOS Keychain. Default: true |
From the publisher's entry in the official MCP Registry. Required settings are already in the install config below as placeholders.
Weekly newsletter
Like WhatsApp MCP? Get the best new MCP servers every week
The best new tools, security warnings before you install something risky, and one practical tip. Free, three minute read.
Alternatives to WhatsApp MCP
All alternatives →Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled.
Market analysis for AI assistants: screeners, multi-timeframe analysis, backtests, in-chat charts.
Cited company knowledge from Slack, meetings, transcripts, and decisions
Minimal chat-first app with durable threads, actions, and the app-agent loop
Central Slack/Telegram router with jobs, memory, approvals, and A2A delegation
Agent-Native Superhuman - email client with keyboard shortcuts and AI triage
WhatsApp MCP: common questions
How do I install WhatsApp MCP?
In Claude Code run claude mcp add whatsapp-mcp -- uvx adelaidasofia-whatsapp-mcp. For Claude Desktop, Cursor and VS Code, paste the config shown above and restart. See the install guides.
Is WhatsApp MCP the official server?
WhatsApp MCP is a community project by adelaidasofia, not verified by a company domain.
Is WhatsApp MCP free?
The code is published under the MIT licence. The service it connects to may have its own pricing.
Is WhatsApp MCP safe to use?
It scores 51 of 100. Grades: maintenance A, licence A, quality C. The security check has not run for it yet. Review the code before you install. How grades work.
What are alternatives to WhatsApp MCP?
Similar MCP servers: Vexa, TradingMCP, Agent-Native Brain, Agent-Native Chat.
Does WhatsApp MCP work with ChatGPT?
Not directly. It runs locally, and ChatGPT only connects to remote servers with a URL. Use it in Claude Code, Claude Desktop, Cursor, VS Code or Codex.
