list_messages
Get messages with filters, date ranges, and sorting.
How to use it
list_messages is exposed by the Whatsapp MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), and the list_messages tool becomes available to the model automatically. See the full listing for setup details and every tool this server provides.
Install Whatsapp MCP
uv pip install -e ".[dev]"Other tools in Whatsapp MCP (39)
(optional): Number of messages after (default 5)
(optional): Messages after this date (YYYY-MM-DD)
(optional): Number of messages before (default 5)
(optional): Messages before this date (YYYY-MM-DD)
(optional): Caption for the media
(optional): Filter by specific chat JID
Download media from a received message.
(required): Reaction emoji (e.g. "👍"). Pass an empty string "" to remove an existing reaction.
(required): Path to the file
(optional, default false): Whether the original message was sent by the current user
Get specific chat metadata by JID.
Resolve a WhatsApp contact name from a phone number, LID, or full JID.
List all chats involving a specific contact.
Find a direct message chat with a contact.
Get the last message exchanged with a contact.
Get messages around a specific message for context.
(required): Phone number, LID, or full JID (aliases: phonenumber, phone)
(required): Chat JID
(optional): Number of messages (default 50, max 500)
List all chats with metadata.
Mark one or more messages from the same chat and sender as read. This explicitly
(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
(required): Text content to send
(required): ID of the message to react to
(required): IDs of messages from the same chat and sender
(required): Phone number of the contact
(required): Name or phone number to search
(optional): Text content of the quoted message, used for the reply preview. Only plain text is supported.
(optional): ID of the message to reply to. When provided, the sent message appears as a quoted reply in WhatsApp.
(optional): Full JID of the author of the quoted message. Required for group replies so WhatsApp renders the correct attribution header.
(required): Phone number or group JID
Search contacts by name or phone number.
Send a voice message (automatically converts to Opus .ogg format).
Send a media file (image, video, document).
Send a text message to a contact or group, optionally as a quoted reply.
Send (or remove) an emoji reaction to a message.
(required for groups): Full JID or bare phone number of the original message sender
(optional): "newest" or "oldest" (default "newest")
(optional): RFC 3339 read timestamp; defaults to the current time