List chats
list_chatsLists recent iMessage and SMS conversations, newest first, and filters by name, phone number, or email to find the chat_id needed for other messaging actions.
Instructions
Lists recent iMessage/SMS conversations, newest activity first, optionally filtered by a name, phone number or email. Returns each chat's chat_id (used by the other tools), name, participants, service and last activity time. Group names are set by participants and are flagged as untrusted content.
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 chats to return. Default 20, max 100. | |
| query | No | Filter by chat name, contact name, phone number or email (case-insensitive). |