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. It runs locally over stdio via the published package.

People who work with obsidian, productivity and whatsapp and want it reachable from Claude, Cursor, VS Code, or another MCP client. The project is written in Go.

VERIFIED ACTIVE

LAST COMMIT 2026-09-28 · ★ 2 · #47 OF 109 MAINTAINED COMMUNICATION · VERIFIED 2026-09-30

MIT · Go servers · how we verify → /methodology

01 · Install WhatsApp MCP

before you install - you'll need

The README does not document required environment variables for a basic install.

Claude Code

claude mcp add adelaidasofia-whatsapp-mcp -- uvx adelaidasofia-whatsapp-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "adelaidasofia-whatsapp-mcp": {
      "command": "uvx",
      "args": [
        "adelaidasofia-whatsapp-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package adelaidasofia-whatsapp-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.adelaidasofia is GitHub-verified and matches the repo owner

03 · What WhatsApp MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.4.1 · 2026-08-26

Update if your WhatsApp bridge stopped receiving messages · On 2026-08-24 WhatsApp stopped accepting the client version this bridge shipped with. If you are on v0.4.0 or earlier, your bridge is not connected, and it…

v0.4.0 · 2026-08-19

This is the release to install. The previous one (v0.3.1, July 24) predates two significant fixes that have been sitting on main unreleased - including the one that stopped the vault export from silently dropping…

v0.3.1 · 2026-07-25

keep chosen chats out of voice-note transcription · Set WHATSAPP_WHISPER_EXCLUDE_CHATS to a comma-separated list and any chat whose name or JID matches one of those patterns is never transcribed. Matching is…

04 · Who maintains WhatsApp MCP

WhatsApp MCP is maintained by adelaidasofia. We track 18 MCP servers from adelaidasofia - 18 actively maintained, 20 combined GitHub stars, oldest repo from Apr 2026. Full record: all servers from adelaidasofia.

  1. instagram-mcp Official, multi-account Instagram Graph API MCP: read, publish, analytics, comments, DMs. ★ 6
  2. FastMCP server for Apollo FastMCP server for Apollo.io - 22 tools: sequences, campaign health, mailbox warmup, enrichment,… ★ 3
  3. Multi-account MCP for Gmail, Calendar, Drive, Docs, and Sheets - 61 tools, token Multi-account MCP for Gmail, Calendar, Drive, Docs, and Sheets - 61 tools, token-efficient, macOS… ★ 3
  4. macOS-only MCP server that exposes iMessage chat macOS-only MCP server that exposes iMessage chat.db to Claude and exports per-chat history to an… ★ 2
  5. FastMCP server for surgical queries against a vault knowledge graph (NetworkX no FastMCP server for surgical queries against a vault knowledge graph (NetworkX node-link JSON).… ★ 2

05 · Facts

repository
github.com/adelaidasofia/whatsapp-mcp
category
communication - ranked #47 of 109 actively-maintained communication servers as of 2026-09-30.
release cadence
5 releases in the last 90 days (latest 2026-08-26)
registry
io.github.adelaidasofia/whatsapp-mcp (active, first published 2026-05-20 · 2 versions)
packages
pypi:adelaidasofia-whatsapp-mcp

06 · WhatsApp MCP FAQ

What is 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. It runs locally over stdio via the published package.

Is WhatsApp MCP still maintained?

Yes - as of 2026-09-30, its last commit was 2026-09-28 and it shipped 5 releases in the last 90 days. We re-verify nightly.

How do I install WhatsApp MCP?

Run `uvx adelaidasofia-whatsapp-mcp`. The README does not document required environment variables for a basic install. You can also paste the ready-made client config above.

Does WhatsApp MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to WhatsApp MCP

Alternatives to WhatsApp MCP

Maintained communication servers if WhatsApp MCP isn't the fit.

  1. Draw Io Create diagrams in chat, rendered as live interactive draw.io diagrams. 10,000+ searchable shapes. ★ 5,550 · 2026-09-24
  2. Mockserver Mock, record/replay, verify and chaos-test any HTTP, REST, gRPC or LLM dependency over MCP. ★ 4,977 · 2026-09-29
  3. Vexa Meeting bot and transcripts for Google Meet, Teams and Zoom. Live or after, speakers labelled. ★ 2,841 · 2026-09-28
  4. Evolution API MCP server for Evolution API - WhatsApp messaging, instances, contacts ★ 271 · 2026-09-27
  5. Agenticmail MCP Server Real email and SMS for AI agents - send mail, receive verification codes, drive a real inbox. ★ 229 · 2026-09-28
  6. Discord MCP Caller-owned Discord operations for AI agents with 209 typed tools and verifiable guild builds. ★ 169 · 2026-09-30

Pairs well with

Servers that cover what WhatsApp MCP doesn't - only shown when the pairing reason fits the companion.

  1. Basic Memory → productivity companion productivity · ★ 4,068
  2. Praison AI → productivity companion productivity · ★ 9,111
  3. Emailmd → email companion email · ★ 1,380
  4. Email MCP (codefuturist) → email companion email · ★ 122

More communication MCP servers · Pickle · Agent Phone · Agentspore · Yzel - 1C:Enterprise

More Go MCP servers · ToolTrust Scanner · Dibs · Dir MCP · Aispace · Git Courer · see all