List mail summaries (date/from/subject/message_id). Use --query for full-text search, --filter for exact-match conditions.
maxmaximum number of messages to fetch (1-400; auto-paginates internally) (default 20)
querystringfull-text keyword search across from/to/subject/body (max 50 chars). Example: "budget report"
filterstringexact-match condition filter (JSON). Narrow results by folder, label, sender, recipient, etc. Run --print-filter-schema to see all fields. Example: {"folder":"INBOX","from":["alice@example.com"]}
labelsbooleaninclude label IDs in output
mailboxstringemail address (default: me) (default "me")
pageSizeintegeralias for --max
pageTokenstringpagination token from a previous response to fetch the next page
printFilterSchemabooleanprint --filter field reference and exit
No reviewed structured output summary is available.
API key connection. Risk level 1 of 5.
Free Action
No published Skills explicitly reference this Action yet.