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_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.
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. |
folder | No | string | Folder role (inbox, sent, drafts, trash, spam, starred, archive, all) or a label/folder name. Use all or omit this field to search all mail except Spam and Trash. An IMAP server's \All mailbox may use different rules. Minimum length: 1. |
text | No | string | Literal full-text search terms |
from | No | string | None |
to | No | string | None |
subject | No | string | None |
read | No | boolean | None |
starred | No | boolean | None |
hasAttachment | No | boolean | None |
after | No | string | YYYY-MM-DD received date, inclusive in UTC Minimum length: 1. |
before | No | string | YYYY-MM-DD received date, exclusive in UTC Minimum length: 1. |
rawProviderQuery | No | string | Provider-native Gmail syntax or Outlook KQL for one compatible account |
pageSize | No | integer | Defaults to 25 Minimum: 1. Maximum: 100. |
pageToken | No | string | nextPageToken from a previous call Minimum length: 1. |
{
"type": "object",
"properties": {
"accountId": {
"type": "string",
"minLength": 1,
"description": "Account to operate on. Optional when exactly one account is connected."
},
"folder": {
"type": "string",
"minLength": 1,
"description": "Folder role (inbox, sent, drafts, trash, spam, starred, archive, all) or a label/folder name. Use all or omit this field to search all mail except Spam and Trash. An IMAP server's \\All mailbox may use different rules."
},
"text": {
"type": "string",
"description": "Literal full-text search terms"
},
"from": {
"type": "string"
},
"to": {
"type": "string"
},
"subject": {
"type": "string"
},
"read": {
"type": "boolean"
},
"starred": {
"type": "boolean"
},
"hasAttachment": {
"type": "boolean"
},
"after": {
"type": "string",
"minLength": 1,
"description": "YYYY-MM-DD received date, inclusive in UTC"
},
"before": {
"type": "string",
"minLength": 1,
"description": "YYYY-MM-DD received date, exclusive in UTC"
},
"rawProviderQuery": {
"type": "string",
"description": "Provider-native Gmail syntax or Outlook KQL for one compatible account"
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Defaults to 25"
},
"pageToken": {
"type": "string",
"minLength": 1,
"description": "nextPageToken from a previous call"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Last updated