read_thread
Retrieve iMessage history from a specific chat in chronological order, with optional date filter and message limit for focused review.
Instructions
Read messages from one chat, in date order.
chat accepts a chat ROWID, a chat guid/chat_identifier, or a case
insensitive substring of a contact/display name. If the name is
ambiguous, this returns a list of candidate chats instead of messages.
since is an optional "YYYY-MM-DD" or "YYYY-MM-DD HH:MM" local time
filter. limit caps how many of the most recent matching messages come
back (still returned oldest first).
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"chat": "<chat>"
},
"name": "read_thread"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chat | Yes | ||
| limit | No | ||
| since | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |