Gmail
GMAIL_FETCH_EMAILS
Fetches a list of email messages from a gmail account, supporting filtering, pagination, and optional full content retrieval.
Remote gmail
Other tools also called GMAIL_FETCH_EMAILS?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"title": "Query",
"default": null,
"examples": [
"from:[email protected] is:unread",
"subject:meeting has:attachment",
"after:2024/01/01 before:2024/02/01",
"is:important OR is:starred",
"label:work -label:spam"
],
"nullable": true,
"description": "Gmail advanced search query (e.g., 'from:user subject:meeting'). Supports operators like 'from:', 'to:', 'subject:', 'label:', 'has:attachment', 'is:unread', 'after:YYYY/MM/DD', 'before:YYYY/MM/DD', AND/OR/NOT. Use quotes for exact phrases. Omit for no query filter."
},
"user_id": {
"type": "string",
"title": "User Id",
"default": "me",
"examples": [
"me",
"[email protected]"
],
"description": "User's email address or 'me' for the authenticated user."
},
"verbose": {
"type": "boolean",
"title": "Verbose",
"default": true,
"examples": [
"True",
"False"
],
"description": "If false, uses optimized concurrent metadata fetching for faster performance (~75% improvement). If true, uses standard detailed message fetching. When false, only essential fields (subject, sender, recipient, time, labels) are guaranteed."
},
"ids_only": {
"type": "boolean",
"title": "Ids Only",
"default": false,
"examples": [
"True",
"False"
],
"description": "If true, only returns message IDs from the list API without fetching individual message details. Fastest option for getting just message IDs and thread IDs."
},
"label_ids": {
"type": "array",
"items": {
"type": "string",
"properties": {}
},
"title": "Label Ids",
"description": "Filter by label IDs; only messages with all specified labels are returned. Common IDs: 'INBOX', 'SPAM', 'TRASH', 'UNREAD', 'STARRED', 'IMPORTANT', 'CATEGORY_PRIMARY' (alias 'CATEGORY_PERSONAL'), 'CATEGORY_SOCIAL', 'CATEGORY_PROMOTIONS', 'CATEGORY_UPDATES', 'CATEGORY_FORUMS'. Use 'listLabels' action for custom IDs."
},
"page_token": {
"type": "string",
"title": "Page Token",
"default": null,
"nullable": true,
"description": "Token for retrieving a specific page, obtained from a previous response's `nextPageToken`. Omit for the first page."
},
"max_results": {
"type": "integer",
"title": "Max Results",
"default": 1,
"maximum": 500,
"minimum": 1,
"examples": [
"10",
"100",
"500"
],
"description": "Maximum number of messages to retrieve per page."
},
"include_payload": {
"type": "boolean",
"title": "Include Payload",
"default": true,
"examples": [
"True",
"False"
],
"description": "Set to true to include full message payload (headers, body, attachments); false for metadata only."
},
"include_spam_trash": {
"type": "boolean",
"title": "Include Spam Trash",
"default": false,
"examples": [
"True",
"False"
],
"description": "Set to true to include messages from 'SPAM' and 'TRASH'."
}
}
}