List Chats
list-chatsRetrieve recent iMessage and SMS conversations, newest first, and filter by date to find chats active within a specific period.
Instructions
List recent iMessage/SMS conversations, most recent first. Use since to get only the conversations active after a date (e.g. the last 7 days).
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 conversations to return (default 20) | |
| since | No | Only conversations with a message at or after this date (ISO 8601, optional) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| items | Yes | Recent conversations | |
| total | Yes | Number of items returned |