cipp_get_mailbox_usage
Retrieve live mailbox and online-archive sizes, item counts, quotas, and percentage used for a single mailbox. Reads directly from Exchange, so it works even when tenant usage reports hide names.
Instructions
Report the primary mailbox size and online-archive size for a single mailbox, with item counts, quotas and percent-of-quota. Reads live from Exchange, so unlike cipp_list_mailbox_usage it needs no CIPP report-cache sync and still returns real sizes for a tenant that conceals names in its Microsoft 365 usage reports.
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": {
"tenantFilter": "<tenantFilter>",
"upn": "<upn>"
},
"name": "cipp_get_mailbox_usage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| upn | Yes | User Principal Name or Entra object ID of the mailbox owner (e.g. alice@contoso.com). | |
| tenantFilter | Yes | Tenant domain name or ID that owns the mailbox. 'allTenants' is not supported here — this tool reads one mailbox at a time. |