sender_summary
Groups every message in a folder by sender and reports counts plus opened versus unread rates, giving evidence to decide which senders to keep or delete before acting.
Instructions
Group a whole folder by sending address and report, per sender, how many messages there are and how many were actually opened.
This is the tool to reach for before proposing anything for deletion. A sender's read rate is measured evidence of whether the mailbox owner wants their mail; guessing from the brand name is not, and gets it wrong.
Returns rows {sender, brand, domain, count, read, unread, read_pct,
newest, oldest, sample_ref}, biggest sender first. brand is a heuristic
display label — never group or delete by it. brand_shared: true marks a
row whose brand label also belongs to another address in the result
(e.g. a billing subdomain and a marketing subdomain of one company):
those are different senders and must stay separate.
Args: folder: folder id or well-known name. min_count: drop senders with fewer than this many messages. top: return at most this many sender rows (after sorting by count). max_results: cap on messages scanned. unread_only: summarise only unread mail.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | ||
| folder | No | inbox | |
| min_count | No | ||
| max_results | No | ||
| unread_only | No |