Search WhatsApp Messages
whatsapp_search_messagesSearch your entire WhatsApp history for specific messages using text, date range, sender, and type filters.
Instructions
Search across all WhatsApp message history. Supports full-text search, date ranges, sender filtering, and message type filtering.
Args:
search: Text to search for (case insensitive, supports Portuguese/unicode)
contactId: Scope search to one contact (phone digits or "*@g.us") (optional)
sender: Filter by sender name or JID (optional)
since: ISO date string — messages after this date (optional)
until: ISO date string — messages before this date (optional)
type: Message type filter: chat, image, album, e2e_notification (optional)
fromMe: Filter sent (true) or received (false) messages (optional)
limit: Results per page (1-100, default 20)
offset: Pagination offset (default 0)
Returns:
messages: Array with id, chatJid, senderName, body, timestamp, messageType, fromMe
total: Total matching messages
has_more: Whether more results exist
Note: sender_name may be null for some messages.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| search | Yes | Text to search for (case insensitive) | |
| contactId | No | Scope search to one contact: phone digits (person) or "*@g.us" (group). Optional. | |
| sender | No | Filter by sender name or JID (optional) | |
| since | No | ISO date string — only messages after this date (optional) | |
| until | No | ISO date string — only messages before this date (optional) | |
| type | No | Message type filter: chat, image, album, e2e_notification (optional) | |
| fromMe | No | Filter: true = sent, false = received (optional) | |
| limit | No | Results per page (1-100, default 20) | |
| offset | No | Pagination offset (default 0) |