n8n community node
Coming soon. Source is in
packages/n8n-node; the npm package and the n8n.io listing are not live yet. Until then, use an n8n HTTP Request node pointed atPOST https://humanhours.dev/api/v1/trackwith your Bearer token. That's the same call the community node will eventually make.
n8n-nodes-humanhours will add a humanhours node + a humanhours API credential to n8n. Drop it at the end of any workflow that runs an AI agent and the dashboard fills in.
Local install
cd packages/n8n-node
pnpm install
pnpm build
mkdir -p ~/.n8n/custom
cd ~/.n8n/custom
pnpm init
pnpm add /path/to/agent-metrics/packages/n8n-node
Restart n8n. The humanhours node shows up under Transform.
Credential
Create a humanhours API credential with:
- API Key —
hh_live_...from /api-keys in the dashboard. - Base URL — defaults to
https://humanhours.dev. Override only for self-hosted or local dev.
The credential's "Test connection" button hits GET /api/v1/agents to verify.
Track Event operation
| Field | Required | Description |
|---|---|---|
| Agent ID | yes | slug, e.g. support-classifier |
| Task Type | yes | one of the 50 built-in keys, or your custom |
| Outcome | yes | success / failure / needs_review |
| Agent Duration (seconds) | no | omit for 0 |
| Human Baseline (minutes) | no | override the built-in for this event |
| Metadata | no | free-form JSON object |
The node sends an Idempotency-Key derived from the n8n execution id, so re-runs of the same workflow item are safe.
Patterns
Pattern 1: end of a single-node agent. Drop a humanhours node at the end of an OpenAI / Claude / HTTP-Request flow. Wire agent_id to a workflow constant, task_type to whatever the workflow does.
Pattern 2: branch on outcome. Use an If node to set outcome based on the agent's structured output, then feed both branches into a single humanhours node.
Pattern 3: include token cost. Wire metadata to {{ {model: "claude-opus-4-7", tokens_in: $json.usage.prompt_tokens, tokens_out: $json.usage.completion_tokens} }} so the dashboard can break down by model later.
Roadmap
- Get Summary operation
- List Agents operation
- Get Time Saved report
An n8n.io submission is in progress; this page will move from SOON to LIVE once the listing is approved.