list_mails
List emails in a mailbox, with optional folder filter and pagination to browse messages.
Instructions
List mails in a mailbox, optionally filtered by folder. Scope: mail:read
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_id": "<mailbox_id>"
},
"name": "list_mails"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, default 1 | |
| folder | No | Folder name, e.g. INBOX | |
| per_page | No | Items per page, default 25 | |
| mailbox_id | Yes |