get-unread-count
Retrieve the number of unread emails in a selected account or mailbox without fetching message details.
Instructions
Use when: you only need the number of unread messages (optionally scoped to one mailbox and/or account), without listing the messages themselves. Returns: the unread count for the requested scope. Do not use when: you need the actual unread messages and their ids (use list-messages with unreadOnly, or search-messages with isRead=false) or broader totals (use get-mail-stats).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | Account to check | |
| mailbox | No | Mailbox to check (default: all) |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| unread | No | ||
| account | No | ||
| mailbox | No |