list-messages
Retrieve recent email messages from Apple Mail with optional filters by sender or unread status. Supports pagination to browse through messages and returns IDs for further actions.
Instructions
Use when: browsing a mailbox's recent messages (optionally filtered by sender or unread-only) with pagination via limit/offset, and you need their ids. Returns: messages with id, date, subject, and sender (plus partial-coverage diagnostics when some mailboxes were skipped). Do not use when: you have specific search criteria like subject/date/flags (use search-messages) or already have an id and want the body (use get-message). Like search-messages, use this to obtain the ids that read/mark/delete/move and batch tools require.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | Filter by sender email address or name | |
| limit | No | Maximum number of messages (default: 50, max: 500) | |
| offset | No | Number of messages to skip (for pagination) | |
| account | No | Account to list messages from | |
| mailbox | No | Mailbox to list messages from. Omit to list from all mailboxes. | |
| unreadOnly | No | Only show unread messages |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| partial | No | ||
| messages | No | ||
| timedOutAccounts | No | ||
| notSearchedMailboxes | No | ||
| skippedLargeMailboxes | No |