messages_search_messages
Search iMessage conversations for specific text, sender, or within a chat ID, with options to limit results by date and quantity.
Instructions
[iMessage operations] Search for messages containing specific text or from a specific sender
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| chatId | No | Limit search to a specific chat ID | |
| daysBack | No | Limit search to messages from the last N days | |
| limit | No | Maximum number of messages to retrieve | |
| searchText | Yes | Text to search for in messages | |
| sender | No | Search for messages from a specific sender (phone number or email) |
Input Schema (JSON Schema)
{
"properties": {
"chatId": {
"default": "",
"description": "Limit search to a specific chat ID",
"type": "string"
},
"daysBack": {
"default": 30,
"description": "Limit search to messages from the last N days",
"type": "number"
},
"limit": {
"default": 50,
"description": "Maximum number of messages to retrieve",
"type": "number"
},
"searchText": {
"default": "",
"description": "Text to search for in messages",
"type": "string"
},
"sender": {
"default": "",
"description": "Search for messages from a specific sender (phone number or email)",
"type": "string"
}
},
"required": [
"searchText"
],
"type": "object"
}