mail_list_messages
List recent messages from any IMAP folder with sorting, pagination, and optional plain-text snippets. Retrieve envelopes quickly to browse emails without full content.
Instructions
List recent messages in a folder (envelope only by default). Supports sort/cursor/snippet options.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"mailbox": "<mailbox>"
},
"name": "mail_list_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort by UID (default: desc/newest-first) | desc |
| limit | No | Max number of messages to return (default 50, capped globally) | |
| cursor | No | Opaque pagination cursor from previous response | |
| mailbox | Yes | Folder name, e.g. INBOX or Sent | |
| returnPage | No | Return {items,nextCursor} instead of raw array | |
| includeSnippet | No | Include short plain-text snippet per message |