mail_list_unread
List unread messages in a specified mailbox folder. Supports sorting by UID, pagination with cursor, and optional plain-text snippets.
Instructions
List unread 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_unread"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sort | No | Sort by UID (default: desc/newest-first) | desc |
| limit | No | Max number of unread messages to return (default 50, capped globally) | |
| cursor | No | Opaque pagination cursor from previous response | |
| mailbox | Yes | Folder name, e.g. INBOX | |
| returnPage | No | Return {items,nextCursor} instead of raw array | |
| includeSnippet | No | Include short plain-text snippet per message |