list-messages
Retrieve a paginated list of messages from a mailbox, filtered by sender or unread status. Get IDs, dates, subjects, and senders 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 |