get_conversation
Retrieve complete conversation threads from iMessage history with pagination support for scrolling through past messages and filtering by date range.
Instructions
Get a full conversation thread with a specific contact or chat. Supports cursor-based pagination via before_rowid (backward) or after_rowid (forward) for scrolling through history.
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": "get_conversation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| contact | No | Contact handle (phone/email) or name | |
| chat_id | No | Chat identifier (e.g. chat123456789) | |
| limit | No | Max messages (default 50, max 500) | |
| before_rowid | No | Cursor: only messages before this ROWID (for pagination) | |
| after_rowid | No | Cursor: only messages after this ROWID (for catching up on new messages) | |
| date_from | No | Start date filter | |
| date_to | No | End date filter |