mail_get_email
Retrieve specific emails from Mail.app on macOS using search criteria like subject, sender, date, or mailbox. Includes option to fetch email body if needed.
Instructions
[Mail operations] Get a specific email by search criteria from Mail.app
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | Name of the account to search in (e.g., 'iCloud', 'Gmail', 'Exchange'). If not specified, searches all accounts with preference for iCloud. | iCloud |
| dateReceived | No | Date received to search for (format: YYYY-MM-DD) | |
| includeBody | No | Include email body in the result if true | |
| mailbox | No | Name of the mailbox to search in (e.g., 'Inbox', 'Sent') | Inbox |
| sender | No | Sender email or name to search for (partial match) | |
| subject | No | Subject text to search for (partial match) | |
| unreadOnly | No | Only search unread emails if true |
Input Schema (JSON Schema)
{
"properties": {
"account": {
"default": "iCloud",
"description": "Name of the account to search in (e.g., 'iCloud', 'Gmail', 'Exchange'). If not specified, searches all accounts with preference for iCloud.",
"type": "string"
},
"dateReceived": {
"description": "Date received to search for (format: YYYY-MM-DD)",
"type": "string"
},
"includeBody": {
"default": false,
"description": "Include email body in the result if true",
"type": "boolean"
},
"mailbox": {
"default": "Inbox",
"description": "Name of the mailbox to search in (e.g., 'Inbox', 'Sent')",
"type": "string"
},
"sender": {
"description": "Sender email or name to search for (partial match)",
"type": "string"
},
"subject": {
"description": "Subject text to search for (partial match)",
"type": "string"
},
"unreadOnly": {
"description": "Only search unread emails if true",
"type": "boolean"
}
},
"required": [],
"type": "object"
}