list_chats
Retrieve recent WhatsApp one-to-one and group chats with contact, unread count, timestamp, preview, archive and pin status. Filter by search, unread status, and pagination.
Instructions
List recent 1:1 and group chat sessions from WhatsApp's local storage. Includes contact name, JID, unread count, last message date, last message text preview, archived status, and pinned status.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_chats"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum number of chats to return (default 50, max 200). | |
| offset | No | Number of records to skip for pagination. | |
| search | No | Optional filter matching contact name, group title, or phone number / JID. | |
| unread_only | No | If true, return only chats with unread messages. | |
| include_archived | No | Whether to include archived chats. |