mail_list_folders
List the folders for one email account.
Parameters
Section titled “Parameters”| Parameter | Type | Required | Description |
|---|---|---|---|
account_id | string | Yes | Account ID. Use mail_list_accounts to find IDs. |
A missing or non-string account_id returns JSON-RPC error -32602.
Example
Section titled “Example”{ "tool": "mail_list_folders", "arguments": { "account_id": "acc1" } }Gates and denial reasons
Section titled “Gates and denial reasons”Read tool. Requires Mail enabled, a ready helper, a non-deny global tool policy,
and Allow AI to read Mail. Failures return JSON-RPC error -32008 with one
of mail_feature_disabled, mail_helper_unavailable,
mail_global_policy_denied, or mail_read_consent_required. Full ordering:
API Reference.