List the mail feed
list_feedList the user's mail the way Busymail groups it: clusters of related conversations within a category, newest first. This is the same grouping the user sees on their feed and the best starting point for understanding what is in the mailbox. Each cluster carries its key, category, generated summary where one exists, and how many conversations and emails it holds. Open a cluster with get_cluster, or a single conversation with get_conversation. Narrow by category, or by date with after and before, each optional on its own. If the result comes back with has_more true it was capped at limit and there is no way to page past it: narrow with category, after or before to see the rest. The response also carries two counts, neither narrowed by the category argument: unreadable_conversations, the conversations holding mail extraction gave up on, and processing_conversations, the conversations whose mail is still being read and that no cluster shows yet. Both run over the after and before window asked for, never reaching back past the window this mailbox is read over, and both count conversations where total counts clusters, so neither may be added to total. They never name the same conversation. A non-zero count on either means this listing omits mail, and a zero on one alone says nothing about the other. Both being zero still does not make the listing whole: mail extraction has read but has not yet summarised is in no cluster either.
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": "list_feed"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| after | No | Only clusters whose newest mail arrived from this date onwards, as YYYY-MM-DD. INCLUSIVE: the date itself is included, from midnight. Optional on its own: you may give after, before, both, or neither. | |
| limit | No | Maximum clusters to return (1-200, default 50). | |
| before | No | Only clusters whose newest mail arrived strictly before this date, as YYYY-MM-DD. EXCLUSIVE: the date itself is excluded entirely, so for a single day pass the NEXT day here - one day is after: 2026-07-05, before: 2026-07-06. Optional on its own: you may give after, before, both, or neither. | |
| category | No | Limit to one category. Omit for all categories. |