emailmd
Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.
Self-hosted personal WhatsApp bridge with 86 MCP tools over stdio or Streamable HTTP.
Lists are ordered by a usage score (out of 100) built from these parts
| Popularity | 0/80 | GitHub stars or weekly downloads: the larger counts 60, the smaller 20 |
|---|---|---|
| Freshness | 12/12 | Full marks for a release or code change within 30 days |
| Still answering | 0/8 | The cloud endpoint answered at the last check |
| Usage score | 12/100 |
Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)
Pick the AI app you use, then copy the settings.
Passed 3/3 checks · Runs on your computer
First: which AI do you use?
Pick your app and the steps appear below.
Works with Claude, with some setup first
No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone
Download the maker’s .mcpb file
The .mcpb file comes straight from the maker; we do not change it
Use WhatsApp MCP and tell me what you can do for me, then show me one thing✓ If Claude says it is using WhatsApp MCP or shows a WhatsApp MCP tool in the answer, you are connected
Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version
ChatGPT cannot connect WhatsApp MCP yet
WhatsApp MCP runs on your computer, but ChatGPT can only connect servers that run on the web
A · Use an app that can connect WhatsApp MCP
B · Others in Chat & email that work with ChatGPT
Picked from the most used in the same category, only ones that connect by address with no key
Claude Code cannot connect WhatsApp MCP yet
The maker only provides an installer for the Claude desktop app
A · Use an app that can connect WhatsApp MCP
Cursor cannot connect WhatsApp MCP yet
The maker only provides an installer for the Claude desktop app
A · Use an app that can connect WhatsApp MCP
VS Code cannot connect WhatsApp MCP yet
The maker only provides an installer for the Claude desktop app
A · Use an app that can connect WhatsApp MCP
mcpb: …/whatsapp-mcp_0.2.0_darwin_amd64.mcpbmcpb: …/whatsapp-mcp_0.2.0_darwin_arm64.mcpbmcpb: …/whatsapp-mcp_0.2.0_linux_amd64.mcpbBased on how this server connects and on each app’s own docs, checked Nov 10, 2026.
Run on your computer in
ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Runs on your computer; the tool list appears in your AI app after you install it.
We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 20, 2026
The registry name was verified with the GitHub account muhammedanasmithadi, which owns the repo
Code last changed today
Uses MIT
This one runs on your computer; there is no internet endpoint
Runs on your computer and uses local settings instead
Runs on your computer; we can only read tool lists from internet endpoints
Not checked: only npm and PyPI packages with a version can be checked
If you made this, paste this code into your README. The badge links back to this page.
[](https://mcp.popnx.com/en/servers/muhammedanasmithadi-whatsapp-mcp)Ask, share a tip or report that it does not work. Sorted by what people marked helpful.
No posts yet. Be the first to ask or share.
Posts here are written by users, not the PopNx team.
No reviews yet
Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.
It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.
The registry does not list a required key, though some servers ask you to sign in on first use.
It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).
The GitHub repo last changed today, and the latest version (0.2.0) reached the registry today.
Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need MCPB on your computer.
In the same category: emailmd, Kite Discord Bot Builder, e2a — email for AI agents, Infobip MCP, kernelCAD
Same category, other makers, commands already checked. Official ones first, then by stars.
Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi
Render markdown into email-safe HTML, lint drafts for deliverability problems, and preview emails.
Build and fix Discord bots from a chat. Kite hosts them 24/7, with no code to deploy.
Authenticated email gateway for AI agents — per-agent inboxes, HITL approval, SPF/DKIM verified.
Infobip MCP server for omnichannel communication and messaging. SMS, RCS, WhatsApp, Viber and more.
CAD in ChatGPT and Claude: editable parts, STEP/STL/drawings, in-chat 3D, automatic checks.
| This one WhatsApp MCP | emailmd | Kite Discord Bot Builder | e2a — email for AI agents | Infobip MCP | kernelCAD | |
|---|---|---|---|---|---|---|
| Runs where | Installs on your computer | Cloud or install on your computer | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install | Runs in the cloud, nothing to install |
| Needs a key | No | No | No | No | No | No |
| Add with + in Claude | No | No | No | No | Yes | No |
| Basic checks | 3/3 | 5/5 | 4/4 | 4/4 | 4/4 | 4/4 |
| License | MIT | MIT | AGPL-3.0 | Apache-2.0 | MIT | MIT |
| Price | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry | No cost listed in the registry |
Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.
A self-hosted Model Context Protocol (MCP) server that gives an AI agent read and send access to your personal WhatsApp account. It runs on your machine as a single Go binary, speaks MCP over Streamable HTTP at 127.0.0.1:8765/mcp, and keeps your message history in a local SQLite database.
This is an independent, community project. It is not affiliated with, endorsed by, or operated by Meta Platforms, Inc. or WhatsApp LLC.
Once paired with your phone (the same way you link WhatsApp Web), the daemon:
| Domain | What it does |
|---|---|
| Messages | Read, search, send, edit, delete, and recover messages; read receipts; mark read; schedule messages; reply; react; poll; contact cards; locations; voice-note transcription |
| Statuses (Stories) | Read, view, post, delete statuses; read receipts; status privacy setting |
| Profile | Read/set About text, profile photo, contact metadata (About, verified name, LID, linked devices) |
| Presence | Query contact online/last-seen; set per-chat typing/recording indicators |
| Groups | Create, leave, join via link, participants, name, topic, announce, lock, invite link |
| Channels | Follow/unfollow, mute, list, info, messages |
| Contacts | Local address book (bridge-only; not synced to the phone), search, create, update, delete |
| Blocklist & Privacy | Blocklist, privacy settings (group add, last seen, status, profile, read receipts, online, calls, messages, defense, stickers) |
| Scheduling | Timer-driven scheduled messages that survive restarts |
| Auto-responder | Event-driven out-of-office replies to incoming 1:1 text messages |
| Audit & observability | Audit log, health check, Prometheus metrics, WebSocket events, SSE pairing events |
The daemon exposes 86 MCP tools over Streamable HTTP, serves health (/healthz) and Prometheus metrics (/metrics), and pushes new messages to connected clients over WebSocket (/ws/events).
┌─────────────────┐ Streamable HTTP ┌─────────────────────┐
│ AI agent │◄─────────────────────────►│ whatsapp-mcp │ │ (Claude, etc.) │ /mcp │ MCP server (Go) │ └─────────────────┘ │ • 86 tool handlers │ │ • rate limiting │ │ • SQLite cache │ └──────────┬──────────┘ │ │ whatsmeow multidevice │ protocol (vendored fork) ▼ ┌─────────────────────┐ │ WhatsApp Web │ │ (linked device) │ │ phone ↔ server │ └─────────────────────┘
The daemon wraps whatsmeow, the Go WhatsApp Web multidevice library. Because WhatsApp changes its protocol server-side without notice, the project vendors whatsmeow via a Go replace directive and applies protocol fixes immediately rather than waiting for upstream:
replace go.mau.fi/whatsmeow => ./vendor-whatsmeow/go.mau.fi/whatsmeow
Protocol fixes carried in the fork (also contributed upstream where applicable):
| Fix | What it does |
|---|---|
| SKDM group ID | handleSenderKeyDistributionMessage uses the protobuf groupId, not the enclosing stanza chat, to decide sender-key ownership. This makes statuses and group messages decrypt correctly when retried as direct-to-device SKDMs. Upstream: tulir/whatsmeow#1330 |
| Profile picture tctoken | Media requests include the required token so thumbnails resolve |
| Presence subscribe | Missing id attribute added to presence subscription stanzas |
| Argo decoding | Hard-coded failure and macOS early-return removed |
| SendPresence race | Presence updates no longer race with session teardown |
| GetPrivacySettings | Errors are no longer swallowed |
| set_status_message | WhatsApp Web calls the xwa2_update_text_status MEX mutation (ID 9152604461510864) first, then the legacy stanza. The MEX mutation is account-gated and fails with a 400 CRITICAL error on accounts without the text-status feature, so it is sent only when an emoji or ephemeral duration is requested; the legacy IQ is always sent |
| canonicalContactJID | Wrong suffix @s.client.net → @s.whatsapp.net fixed |
send_audio_message)Download a prebuilt binary from the latest release. Release assets cover Linux (amd64, arm64), macOS (amd64, arm64) and Windows (amd64), with SHA-256 sums in checksums.txt. The binary needs no runtime dependencies except FFmpeg for voice-note transcoding.
Or build from source:
git clone https://github.com/muhammedanasmithadi/whatsapp-mcp.git
cd whatsapp-mcp make build # writes ./bin/whatsapp-mcp
Start the daemon, then open the pairing page:
./bin/whatsapp-mcp serve # starts on 127.0.0.1:8765
Visit http://127.0.0.1:8765/pair, scan the QR code with WhatsApp (Settings → Linked Devices → Link a Device), and the session persists to ./store/whatsapp.db. WhatsApp rotates the session roughly every 20 days; the daemon re-pairs automatically with exponential backoff.
No browser? Run ./bin/whatsapp-mcp login to render the QR in the terminal, or use the phone-number form on /pair.
Add this to your client configuration:
// OpenCode (opencode.jsonc), Claude Code, Cursor, etc.
{ "mcpServers": { "whatsapp": { "type": "http", "url": "http://127.0.0.1:8765/mcp" } } }
Restart your client. The daemon outlives client restarts.
Each release also ships a .mcpb bundle for Linux, macOS and Windows. Install the bundle matching your platform in an MCPB-capable desktop client; the client starts the binary over stdio and fills in the configuration for you.
Pair once before installing the bundle, because stdio mode has no browser to show a QR code:
whatsapp-mcp -store ~/.whatsapp-mcp login
The bundle's store_dir setting defaults to ~/.whatsapp-mcp, and its read_only setting maps to WHATSAPP_MCP_READ_ONLY. To run stdio mode by hand:
whatsapp-mcp -store ~/.whatsapp-mcp stdio -read-only
stdout carries JSON-RPC frames only; every diagnostic goes to stderr.
| Flag / env var | Default | Purpose |
|---|---|---|
-addr / WHATSAPP_MCP_ADDR | 127.0.0.1:8765 | HTTP bind address |
-allow-remote | off | Bind to a non-loopback address (requires WHATSAPP_MCP_TOKEN) |
WHATSAPP_MCP_TOKEN | — | Bearer token for /mcp and /pair/* when remote-bound |
-read-only / WHATSAPP_MCP_READ_ONLY | off | Expose only read/query tools (no send, edit, delete, mark-read, group, blocklist, privacy, status-change tools) |
-log-format / WHATSAPP_MCP_LOG_FORMAT | text | text for human logs; json for structured JSON lines |
WHATSAPP_MCP_MEDIA_ROOT | /uploads/ | File allowlist root for send/download tools |
WHATSAPP_MCP_DEVICE_NAME | WhatsApp MCP | Name shown for this device in WhatsApp → Linked Devices |
WHATSAPP_MCP_FULL_HISTORY_SYNC | off | Backfill older messages for all cached chats after pairing |
-debug / WHATSAPP_MCP_DEBUG | off | Verbose (unredacted) logs |
GET /healthz — JSON: connected, paired, state, uptime_secGET /metrics — Prometheus text format: messages in/out, sends, errors, rate-limited, pairing state, uptimeWS /ws/events — WebSocket broadcast of new-message events as JSONGET /pair/events — Server-Sent Events stream of pairing state transitionsThe server exposes 86 tools, grouped by domain:
| Tool | Description |
|---|---|
send_message | Send a text message to a person or group |
send_file | Upload and send a picture, video, document, or attachment |
send_audio_message | Send an audio file as a voice note (transcodes via ffmpeg if needed) |
send_location | Send a map location |
send_contact_card | Send a contact card (vCard) |
send_poll | Send a poll with 2–32 options |
send_poll_vote | Cast a vote on a poll |
send_reaction | Add or replace an emoji reaction on a message |
send_reply | Send a reply that quotes a previous message |
edit_message | Edit the text of a sent message |
delete_message | Revoke (delete) a sent message |
recover_media | Request WhatsApp to re-send media for a message |
transcribe_voice_note | Transcribe a voice note via the configured STT endpoint |
batch_send_messages | Send multiple messages in one call |
| Tool | Description |
|---|---|
list_status_updates | List cached Status updates grouped by sender |
mark_status_viewed | Send read receipts for a contact's statuses |
send_status | Post a Status update (image/video + caption) |
delete_status | Delete one of your own status updates |
get_status_viewers | Viewers of a status (WhatsApp does not expose this to linked devices; returns empty list with a note) |
set_status_privacy_setting | Set who can see your statuses (all, contacts, close_friends, custom) |
| Tool | Description |
|---|---|
get_contact_info | Live profile metadata (About, profile-picture ID, LID, devices, business verification) |
get_profile_picture | Fetch a contact's or group's profile photo |
set_profile_picture | Set the paired account's profile photo |
set_status_message | Set the About text shown in the profile |
get_presence | Query a contact's online/last-seen state |
send_typing | Show or hide per-chat typing/recording indicator |
send_presence | Set global online/offline availability |
| Tool | Description |
|---|---|
create_group | Create a group with participants |
leave_group | Leave a group |
join_group_with_link | Join a group via invite link |
get_group_info | Get group metadata |
get_group_invite_link | Get or reset a group invite link |
set_group_name | Rename a group |
set_group_topic | Set group topic/description |
set_group_announce | Set announce-only mode |
set_group_locked | Lock/unlock a group |
update_group_participants | Add/remove/promote/demote participants |
mute_chat | Mute/unmute a chat |
pin_chat | Pin/unpin a chat in the chat list |
| Tool | Description |
|---|---|
list_channels | List followed WhatsApp Channels |
follow_channel | Follow a channel |
unfollow_channel | Unfollow a channel |
mute_channel | Mute/unmute a channel |
get_channel_info | Get channel metadata |
list_channel_messages | List messages from a channel |
| Tool | Description |
|---|---|
list_contacts | List local address-book contacts |
create_contact | Create a local contact entry |
update_contact | Update a local contact |
| delete_contact | Delete a