WhatsApp MCP server
WhatsApp MCP. SQLCipher-encrypted, scrubber-CI-gated, draft-and-confirm sends, voice transcription.
0 stars26 downloads/wk
Reviews
Write oneNobody has reviewed WhatsApp MCP yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
WhatsApp MCP tools (11, 5 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
confirm_sendwrite actionCommit a previously-drafted send. This is where the actual WhatsApp network send happens.
healthcheckCheck the Go bridge is running and authenticated. Returns status, schema version, and feature flags.
list_chatsList WhatsApp chats with metadata. Sorted by most recent message time.
list_messagesList messages in a chat. Most recent first by default.
mark_chat_readMark one or more messages as read. Affects your WhatsApp unread count on this device AND across your linked devices. Low-consequence: no draft+confirm needed, this is a one-step call.
search_contactsFind contacts by name or phone number. Accent-insensitive. "Muñoz" matches "munoz", "José" matches "jose", "Zürich" matches "zurich".
send_messagewrite actionCreate a DRAFT text message. Does NOT send until confirm_send is called.
send_reactionwrite actionCreate a DRAFT emoji reaction on a specific message.
send_reply_quotewrite actionCreate a DRAFT reply-quote message that cites a specific earlier message.
send_typing_indicatorwrite actionShow a "typing..." or "paused" indicator to the chat recipient.
set_online_presenceSignal your online/offline presence globally to all chats. Changing this affects your "last seen" visibility per WhatsApp's privacy settings.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 11 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How WhatsApp MCP compares
Against every graded Developer tools MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 83/100
- higher than 65% of 1,119 Developer tools servers
- Tools
- 11
- the typical Developer tools server has 7
- Tools that change things
- 45%
- typical: 5%. Fewer write tools means less an agent can break
- Downloads a week
- 26
- more than 10% of 430 Developer tools servers with a package
What its tools let an agent do: 4 read · 3 change · 4 send or post
Install WhatsApp MCP in Claude Code, Cursor or VS Code
claude mcp add whatsapp-mcp -- uvx adelaidasofia-whatsapp-mcp
What the publisher says
From the WhatsApp MCP repository's README, as published. We do not edit it. Read it on GitHub
whatsapp-mcp
<!-- mycelium-badges:start -->
<!-- mycelium-badges:end -->
<!-- mcp-name: io.github.adelaidasofia/whatsapp-mcp -->
A WhatsApp MCP server for Claude, built directly on whatsmeow. Encrypted at rest, prompt-injection-scrubbed, draft-and-confirm on every send, full audit trail, daily CI security gates. Actively maintained.
Why this one?
The most-starred WhatsApp MCP (lharries/whatsapp-mcp, 5.6K stars) is the architectural reference for this pattern, but has not shipped since July 2025 and leaves the lethal-trifecta problem entirely to the user. This implementation closes the gaps:
Not a fork. The Go bridge is built directly against whatsmeow; the Python MCP layer and SQLite schema are original. Other implementations (lharries, LukasHaas, verygoodplugins) were read as reference only.
What this gives you
Claude can:
- Read your WhatsApp chats, messages, and contacts
- Search messages with accent-insensitive, typo-tolerant matching
- Transcribe voice notes locally via whisper.cpp (Spanish-tuned by default)
- Resolve LID (Linked IDentifier) names instead of numeric placeholders
- Send text messages, reactions, and reply-quotes, with a mandatory confirm_send step between draft and delivery
- Pull matching CRM context from your Obsidian vault when reading a chat
- See only prompt-injection-scrubbed message text, never raw adversarial input
Everything runs locally on your machine. No cloud sync. No telemetry. Optional OpenAI Whisper backend is opt-in, off by default.
Architecture
Two components, both local:
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
WhatsApp MCP: common questions
- Is WhatsApp MCP server safe?
- Mostly: it is graded B (83/100). Read the WhatsApp MCP safety report
- How do I install WhatsApp MCP?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does WhatsApp MCP need an API key?
- Yes. The registry entry asks for
WHATSAPP_WHISPER_API_KEY. - Is WhatsApp MCP maintained?
- The last commit was 47 days ago (2026-09-16). The latest release is v0.1.1.
- How does WhatsApp MCP compare with other Developer tools MCP servers?
- safety score 83/100 (higher than 65% of 1,119 Developer tools servers); tools 11 (the typical Developer tools server has 7); tools that change things 45% (typical: 5%. Fewer write tools means less an agent can break). Full comparison.