Whatsapp MCP

Unclaimed

by verygoodplugins

WhatsApp MCP server - Connect Claude to WhatsApp for reading and sending messages

Install

$uv pip install -e ".[dev]"

Unclaimed listing

Is this your MCP server?

This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.

Claim this server

Tools (40)

after

(optional): Number of messages after (default 5)

after_date

(optional): Messages after this date (YYYY-MM-DD)

before

(optional): Number of messages before (default 5)

before_date

(optional): Messages before this date (YYYY-MM-DD)

caption

(optional): Caption for the media

chat_jid

(optional): Filter by specific chat JID

download_media

Download media from a received message.

emoji

(required): Reaction emoji (e.g. "👍"). Pass an empty string "" to remove an existing reaction.

file_path

(required): Path to the file

from_me

(optional, default false): Whether the original message was sent by the current user

get_chat

Get specific chat metadata by JID.

get_contact

Resolve a WhatsApp contact name from a phone number, LID, or full JID.

get_contact_chats

List all chats involving a specific contact.

get_direct_chat_by_contact

Find a direct message chat with a contact.

get_last_interaction

Get the last message exchanged with a contact.

get_message_context

Get messages around a specific message for context.

identifier

(required): Phone number, LID, or full JID (aliases: phonenumber, phone)

jid

(required): Chat JID

limit

(optional): Number of messages (default 50, max 500)

list_chats

List all chats with metadata.

list_messages

Get messages with filters, date ranges, and sorting.

mark_messages_read

Mark one or more messages from the same chat and sender as read. This explicitly

mentions

(optional): List of users to @-mention, as phone numbers with country code (e.g. ["12025551234"]) or JIDs. For each entry the message text must contain a matching @<number> token (e.g. "thanks @12025551234!"), which recipients' devices render as a highlighted, tappable mention that also notifies the

message

(required): Text content to send

message_id

(required): ID of the message to react to

message_ids

(required): IDs of messages from the same chat and sender

phone

(required): Phone number of the contact

query

(required): Name or phone number to search

quoted_content

(optional): Text content of the quoted message, used for the reply preview. Only plain text is supported.

quoted_message_id

(optional): ID of the message to reply to. When provided, the sent message appears as a quoted reply in WhatsApp.

quoted_sender_jid

(optional): Full JID of the author of the quoted message. Required for group replies so WhatsApp renders the correct attribution header.

recipient

(required): Phone number or group JID

search_contacts

Search contacts by name or phone number.

send_audio_message

Send a voice message (automatically converts to Opus .ogg format).

send_file

Send a media file (image, video, document).

send_message

Send a text message to a contact or group, optionally as a quoted reply.

send_reaction

Send (or remove) an emoji reaction to a message.

sender_jid

(required for groups): Full JID or bare phone number of the original message sender

sort_by

(optional): "newest" or "oldest" (default "newest")

timestamp

(optional): RFC 3339 read timestamp; defaults to the current time