search_messages
Search for messages in iCloud mail using text queries, date ranges, sender filters, and mailbox selection to find specific emails quickly.
Instructions
Search for messages using various criteria
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| dateFrom | No | Start date for search (YYYY-MM-DD format) | |
| dateTo | No | End date for search (YYYY-MM-DD format) | |
| fromEmail | No | Filter by sender email address | |
| limit | No | Maximum number of messages to retrieve | |
| mailbox | No | Mailbox name (default: INBOX) | INBOX |
| query | No | Search query text (searches in subject, from, body) | |
| unreadOnly | No | Search only unread messages |
Input Schema (JSON Schema)
{
"properties": {
"dateFrom": {
"description": "Start date for search (YYYY-MM-DD format)",
"type": "string"
},
"dateTo": {
"description": "End date for search (YYYY-MM-DD format)",
"type": "string"
},
"fromEmail": {
"description": "Filter by sender email address",
"type": "string"
},
"limit": {
"default": 10,
"description": "Maximum number of messages to retrieve",
"type": "number"
},
"mailbox": {
"default": "INBOX",
"description": "Mailbox name (default: INBOX)",
"type": "string"
},
"query": {
"description": "Search query text (searches in subject, from, body)",
"type": "string"
},
"unreadOnly": {
"default": false,
"description": "Search only unread messages",
"type": "boolean"
}
},
"type": "object"
}