Gmail
Gmail_TriageEmails
Apply one triage transition to at most 50 selected messages per call. Per-message transitions converge — a message already in the requested state is a noop — but the tool is not idempotent in query mode: repeated calls with the same query advance to the next chunk, so a blind retry can mutate further messages. This lane owns read/unread, star/unstar, unarchive, untrash, importance, and not-spam. Archive, trash, and report_spam are not available on this tool. ``untrash`` uses per-message restore; other actions use batchModify. Query selectors may match more than 50 messages; each call processes up to 50 remaining actionable matches. ``all_matches_processed`` and ``matched_estimate`` describe that desired-state-filtered selection, while ``complete`` describes only the processed ledger. A query with zero matches returns requested=0, items=[], complete=true, and all_matches_processed=true (vacuous completion).
Remote (network-hosted)
Other tools also called Gmail_TriageEmails?
See providers with this name
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "A scoped Gmail search query. Defaults to no query. Provide exactly one selector: email_ids or query. Common operators/formats: from:, to:, subject:, label:, in:/is:, has:attachment, category:, filename:, before:/after: YYYY/MM/DD, older_than:/newer_than: with d/m/y suffixes, quoted phrases, implicit AND, OR, parentheses grouping, and -/NOT negation. before:/after: date literals are interpreted as midnight PST, not the user's local time; when local calendar-day boundaries matter, pass Unix-second timestamps to before:/after: instead. The query must include at least one positive narrowing term; catch-all is:anywhere / in:anywhere and negative-only expressions are rejected. One call processes at most 50 remaining actionable matches after desired-state filtering; all_matches_processed and the optional approximate matched_estimate describe that actionable selection. For mark_not_spam with a query, selection is restricted to messages currently in Spam. For untrash with a query, selection is restricted to messages currently in Trash. Repeated calls with the same query keep progressing by excluding messages already in the requested triage state. Archive, trash, and report_spam are not available on this tool."
},
"action": {
"enum": [
"mark_read",
"mark_unread",
"star",
"unstar",
"unarchive",
"untrash",
"mark_important",
"mark_not_important",
"mark_not_spam"
],
"type": "string",
"description": "One reversible system-state transition to apply uniformly to the selection."
},
"email_ids": {
"type": "array",
"items": {
"type": "string"
},
"description": "Explicit Gmail message IDs to act on (1-50). Defaults to no explicit IDs. Provide exactly one selector: email_ids or query. Duplicate IDs are removed (first occurrence kept), then the 50-ID cap is applied; blank or malformed IDs fail before any mutation."
},
"include_full_ledger": {
"type": "boolean",
"description": "When true, items includes every processed message (changed/noop and problems). When false (default), items lists only non-success rows so the response stays count-first. Use counts.changed / counts.noop for success volume."
}
}
}