Count received emails
count_messagesCount received messages matching the same search and filters as list_messages.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"inbox_id": "<inbox_id>"
},
"name": "count_messages"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| from | No | Exact From address, case-insensitive. | |
| after | No | Received or sent at or after this time: YYYY-MM-DDTHH:mm:ss, optional 1–3 fractional digits, then Z or ±HH:mm. | |
| query | No | Words or quoted phrases that must all appear in the subject or body. Case-insensitive keyword match, not semantic search; up to 16 terms or phrases. | |
| before | No | Received or sent before this time: YYYY-MM-DDTHH:mm:ss, optional 1–3 fractional digits, then Z or ±HH:mm. | |
| subject | No | Literal, case-insensitive substring of the subject. | |
| inbox_id | Yes | ||
| recipient | No | Exact To, Cc or Bcc address, case-insensitive. | |
| labels_all | No | Require every listed label. An empty array in any label filter adds no condition. | |
| labels_any | No | Require at least one listed label. | |
| labels_none | No | Exclude messages with any listed label. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | Yes |