mail_list_emails
Retrieve and list emails from a specified mailbox in Mail.app on macOS. Filter by account, limit results by count, or display only unread emails. Integrates with AppleScript for automation tasks.
Instructions
[Mail operations] List emails from a specified mailbox in 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 |
count | No | Maximum number of emails to retrieve | |
mailbox | No | Name of the mailbox to list emails from (e.g., 'Inbox', 'Sent') | Inbox |
unreadOnly | No | Only show 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"
},
"count": {
"default": 10,
"description": "Maximum number of emails to retrieve",
"type": "number"
},
"mailbox": {
"default": "Inbox",
"description": "Name of the mailbox to list emails from (e.g., 'Inbox', 'Sent')",
"type": "string"
},
"unreadOnly": {
"description": "Only show unread emails if true",
"type": "boolean"
}
},
"type": "object"
}