Gmail
Gmail_ListEmails
Read emails from a Gmail account. By default returns metadata-only rows (no body/html_body) so high-volume triage stays within the context budget. Pass include_body=True when full message text is needed. Metadata rows still include routing headers (to/cc/bcc/from/reply_to) and email_addresses. Obvious automated emails are excluded from results using no-reply sender patterns and Gmail's non-primary category filters (promotions, social, updates, forums). Set exclude_automated=False to include all emails regardless of source.
Remote gmail
Remote (network-hosted)
Other tools also called Gmail_ListEmails?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"n_emails": {
"type": "integer",
"description": "Number of emails to read (Min 1, Max 100, Default 25). Requests above 100 are clamped; the response includes limit_clamped_to_max=True when that happens."
},
"page_token": {
"type": "string",
"description": "Pagination cursor. Omit or pass None to start from the first page (default None). Copy pagination.next_page_token from a previous response to continue; blank or whitespace-only values are rejected."
},
"include_body": {
"type": "boolean",
"description": "Include the full plain-text and HTML message bodies on each result. Defaults to False (metadata-only rows: id, from/to/cc/bcc/reply_to, subject, snippet, labels, date, email_addresses). Set to True only when the agent needs the full message text; body and html_body are omitted entirely when False."
},
"exclude_automated": {
"type": "boolean",
"description": "Exclude obvious automated email using no-reply sender patterns and Gmail non-primary categories (promotions, social, updates, forums). Set to False when the user wants automated content like calendar invites, marketing emails, or other filtered categories."
}
}
}