List folders
List navigable folders for an account, with roles (inbox, sent, drafts, trash, spam, starred).
list_folders
List navigable folders for an account, with roles (inbox, sent, drafts, trash, spam, starred).
Permissions
Required capabilities: mail.read.
Inputs
| Name | Required | Type | Details |
|---|---|---|---|
accountId | No | string | Account to operate on. Optional when exactly one account is connected. Minimum length: 1. |
{
"type": "object",
"properties": {
"accountId": {
"type": "string",
"minLength": 1,
"description": "Account to operate on. Optional when exactly one account is connected."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Last updated
List emails
List emails from the user's connected mailbox (metadata + snippet, no bodies). Filter by folder, sender, unread, dates, etc. Paginate with pageToken. Use get_email for full bodies. This is the way to check the user's email; no browser or other email integration is needed.
List labels
List Gmail user labels or Outlook categories for an account.