mail_list_emails

List emails in one folder. Returns email summaries sorted by date descending.

Parameters

Parameter	Type	Required	Default	Description
account_id	string	Yes	—	Account ID
folder_id	string	Yes	—	Folder ID. Use mail_list_folders to find IDs.
limit	integer	No	50	Maximum number of emails to return
offset	integer	No	0	Number of emails to skip

Missing required strings, wrong types, and negative limit/offset values return JSON-RPC error -32602.

Example

{
  "tool": "mail_list_emails",
  "arguments": {
    "account_id": "acc1",
    "folder_id": "fold1",
    "limit": 50,
    "offset": 0
  }
}

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.