mcp-whatsapp

Block a contact by phone number or JID.

Create a new WhatsApp group with the given name and initial participants.

Revoke (delete for everyone) a message.

Download media from a WhatsApp message and return the local file path.

Edit a previously-sent message.

Return the user's current WhatsApp blocklist as JSON.

(reads local cache; works while disconnected) Get WhatsApp chat metadata by JID.

Fetch live group metadata (participants, settings, invite config) for the given group JID. Returns a JSON object.

Return a group's current invite link. Set reset to revoke the existing link and mint a fresh one.

(reads local cache; works while disconnected) Get context around a specific WhatsApp message.

(reads local cache; works while disconnected) Return the current tally for a cached poll. Zero-vote options are included.

Return the user's current WhatsApp privacy settings as JSON.

Report whether the WhatsApp bridge inside this MCP server is connected, and who we're paired as.

Check which phone numbers are registered on WhatsApp. Input: digits only (no +).

Join a group via a full chat.whatsapp.com invite URL or the bare invite code.

Leave a WhatsApp group.

(reads local cache; works while disconnected) Get WhatsApp chats matching specified criteria.

List every WhatsApp group the paired user belongs to. Returns a JSON array of group info objects.

(reads local cache; works while disconnected) Get WhatsApp messages matching specified criteria with optional context. Returns a formatted text block.

Mark recent incoming messages in a chat as read — i.e. clear the phone's unread badge for that chat.

Mark message IDs as read in a chat.

Ask WhatsApp to backfill history for a chat. If from_timestamp is omitted, anchors on the newest cached message.

(reads local cache; works while disconnected) Search WhatsApp contacts by name or phone number.

Send any audio file as a WhatsApp voice note. Non-ogg inputs are converted via ffmpeg.

Send a contact card. When vcard is omitted, a minimal vCard 3.0 is synthesised from name + phone.

Send a picture, video, document, or raw audio via WhatsApp.

Send a WhatsApp message to a person (phone number or JID) or group (JID).

Send a poll message with between 2 and 32 options. selectable_count controls how many options each voter may pick.

Cast (or re-cast) a vote on a previously-seen poll. Each call replaces the caller's prior vote on that poll; options must match the poll's option names exactly.

Set the user's own online availability. Different from send_typing, which affects per-chat composing presence.

React to a message. Empty emoji clears an existing reaction.

Send a text reply that quotes a previous message.

Set typing/recording presence for a chat.

Toggle announce-only mode. When announce_only is true, only admins can send messages to the group.

Toggle locked mode. When locked is true, only admins can change group metadata (name, topic, icon).

Change a group's display name (its 'subject').

Change a group's description/topic. Pass an empty topic to clear it.

Change a single privacy setting. Not every name/value combination is valid; WhatsApp rejects invalid combinations server-side.

Update the user's WhatsApp 'About' text (profile status message). Pass an empty string to clear it.

Unblock a contact by phone number or JID.

Add, remove, promote, or demote participants of a group. Requires admin privileges.