Billing
Usage
What counts toward your allowances, and where to see it
What counts
| Allowance | Counts | Doesn’t count |
|---|---|---|
| Queries + nodes | Each metered tool call (MCP, REST or CLI) counts 1. Each node created counts 1 — by hm_store, hm_ingest, enrichment or document processing. | tools/list, dashboard reads, failed calls. |
| Documents | Each file uploaded for processing, from any surface. | Re-downloading or listing files. |
| Meetings | Each meeting the meeting bot joins. | Meetings it’s told to skip. |
| Notes read by AI | Each note the AI reads for the first time. | Notes it has already read. |
Paid allowances renew every month on your usage period’s anniversary: the day your subscription started, or your first metered use. On Free, documents, meetings and notes renew the same way; the 6,000 queries + nodes are granted once and never renew. Business adds a one-time 50,000 queries + nodes in its first month.
Where to see your usage
| Place | Shows |
|---|---|
| Billing page | Queries + nodes and documents used this month, against your plan. |
| Files page | Documents used and when the allowance resets. |
| Dashboard | API calls, per-key usage and recent performance. |
| Analytics | Activity, tool usage and enrichment workers. |
| Tokens | AI token usage reported by your agents — see Token usage. |
A banner across the dashboard warns you at 90% of an allowance and when a Free allowance is used up. It also tells you if a payment failed.
At the limit
| Plan | What happens |
|---|---|
| Free | Calls that would go over return HTTP 402 with a plan-limit error. The queries + nodes pool needs an upgrade; documents, meetings and notes come back next usage period. |
| Paid plans | Nothing stops. Usage past the allowance is billed as overage. |
| Every plan | Creating a graph beyond your plan’s graph count is refused. Notes read by AI stop at the allowance. |
The CLI exits with code 4 on a plan limit, so scripts can tell it apart from other errors.
Exporting usage
To download your tool-call history as CSV (tool, key prefix, time, duration, status, error type, request id, source), call GET /api/usage/export from a signed-in browser session. It covers the last 30 days by default.