get-unread-count
Retrieve the number of unread emails in your INBOX or a specific mailbox and account. Get a quick unread count without listing messages.
Instructions
Use when: you only need the number of unread messages — INBOX by default, or scoped to one mailbox and/or account — without listing the messages themselves. Returns: the unread count for the requested scope (INBOX when no mailbox is given). 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 across every mailbox (use get-mail-stats).
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": "get-unread-count"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| account | No | Account to check | |
| mailbox | No | Mailbox to check (default: INBOX) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| unread | No | ||
| account | No | ||
| mailbox | No |