Search emails batch
Search up to 20 accounts with one portable query and return one result group per account.
search_emails_batch
Search up to 20 accounts with one portable query and return one result group per account.
Permissions
Required capabilities: mail.read.
Inputs
| Name | Required | Type | Details |
|---|---|---|---|
accounts | Yes | array of object | None |
query | Yes | string | Typed portable search syntax Minimum length: 1. |
folder | No | inbox or sent or drafts or archive or spam or trash or all | None |
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. |
pageSize | No | integer | Defaults to 25 Minimum: 1. Maximum: 100. |
includeSnippet | No | boolean | Request or suppress message previews |
{
"type": "object",
"properties": {
"accounts": {
"type": "array",
"items": {
"type": "object",
"properties": {
"accountId": {
"type": "string",
"minLength": 1
},
"pageToken": {
"type": "string",
"minLength": 1
}
},
"required": [
"accountId"
],
"additionalProperties": false
},
"minItems": 1,
"maxItems": 20
},
"query": {
"type": "string",
"minLength": 1,
"description": "Typed portable search syntax"
},
"folder": {
"type": "string",
"enum": [
"inbox",
"sent",
"drafts",
"archive",
"spam",
"trash",
"all"
]
},
"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"
},
"pageSize": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Defaults to 25"
},
"includeSnippet": {
"type": "boolean",
"description": "Request or suppress message previews"
}
},
"required": [
"accounts",
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}Last updated
Search emails
Search one account with typed portable syntax. The query supports text, from:, to:, subject:, in:, read and starred states, attachments, and date filters.
Send email
Send an email from the user's connected account; this actually delivers mail, so prefer it over browser automation or leaving a draft when the user asked to send. Three modes: direct (to + subject + body), sending an existing draft (draftId), or replying (replyToMessageId, optionally replyAll) where recipients, subject, and threading are derived from the original. Confirm with the user when intent is ambiguous. Add sendAt to any mode to schedule instead of sending now.