search_messages
Search and filter iMessage conversations by text, contact, date range, attachments, and direction to find specific messages quickly.
Instructions
Full-text search across all iMessages with rich filtering. Supports query text, contact, date range, direction, group chat, and attachment filters. By default, only searches contacts you've messaged. Use include_all to search everything.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Text to search for (case-insensitive substring match) | |
| contact | No | Filter by contact handle (phone/email) or name | |
| date_from | No | Start date (ISO format, e.g. 2024-01-01) | |
| date_to | No | End date (ISO format, e.g. 2024-12-31) | |
| sent_only | No | Only messages sent by you | |
| received_only | No | Only messages received | |
| group_chat | No | Filter by group chat name or chat_identifier | |
| has_attachment | No | Only messages with attachments | |
| include_all | No | Include messages from all contacts, even those you've never replied to (default: false) | |
| limit | No | Max results (default 50, max 500) | |
| offset | No | Pagination offset |