Summarize Email Senders
summarize_sendersCounts a folder's messages by sender without listing them, returning frequency, unread and date summaries to identify high-volume senders for inbox cleanup.
Instructions
Count a folder's messages by sender, server-side, without listing them. Returns one row per sender (count, unread, first and last date, address, name, latest subject), most frequent first — the starting point for cleaning a large inbox: newsletters, promotions and notifications show up as a few hundred senders repeating.
Reads every matching message in the folder (paged internally, up to ~50,000) so the counts are complete; only the summary is returned. Narrow with filter (OData, e.g. a receivedDateTime range) when only part of a folder matters. Use group_by: domain to see families of senders, then group_by: address to get the addresses move_messages_matching needs.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "summarize_senders"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| top | No | How many senders to show (default 100, max 1000) | |
| filter | No | Optional OData filter to narrow the set, e.g. "receivedDateTime lt 2025-01-01T00:00:00Z" | |
| folder | No | Folder to summarise: well-known name (inbox, archive), display name, or ID. Default: inbox | |
| mailbox | No | Email address of another mailbox to act on (delegated or shared), e.g. 'someone@example.com'. Omit for your own mailbox; required when this server signs in as an application. Only addresses this server is configured to allow will be accepted. | |
| group_by | No | Group by full sender address (default) or by the domain after the @ |