mail_list_mailboxes
Retrieve mailboxes from Apple Mail using filters such as account UUID, role (inbox, sent), or name search. Optionally include empty folders and set a limit.
Instructions
List mailboxes/folders with optional filters.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "mail_list_mailboxes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Filter by role: inbox, sent, drafts, junk, trash, archive, outbox, other. | |
| limit | No | Max mailboxes to return (1-100). | |
| query | No | Search mailbox names. | |
| account_uuid | No | Filter by account UUID. | |
| include_empty | No | Include mailboxes with zero messages. |