get_mailbox_summary
Retrieve email statistics including total, unread, and recent message counts for any iCloud Mail folder to monitor inbox activity and manage email organization.
Instructions
Get total, unread, and recent email counts for any specific mailbox/folder
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mailbox | Yes | Mailbox path to summarize (e.g. Newsletters, Archive) |
Implementation Reference
- lib/imap.js:1270-1276 (handler)The handler function `getMailboxSummary` connects to the IMAP server, queries the status of the specified mailbox for message counts (total, unseen, recent), and returns the summary.
export async function getMailboxSummary(mailbox, creds = null) { const client = createRateLimitedClient(creds); await client.connect(); const status = await client.status(mailbox, { messages: true, unseen: true, recent: true }); await client.logout(); return { mailbox, total: status.messages, unread: status.unseen, recent: status.recent }; }