Set up TokenSense for n8n
Choose your install path below. Both end at the same place — a configured TokenSense credential ready to track costs.
n8n Cloud
You'll be able to install it from the n8n Cloud nodes panel in one click. Join the waitlist and we'll email you the moment it's live.
Self-hosted n8n
Install TokenSense from the Community Nodes settings:
- Go to Settings → Community Nodes in your n8n instance
- Click Install a community node
- Enter
n8n-nodes-tokensenseand click Install
After install, the TokenSense nodes appear in your nodes panel. Next step: configure your credential.
Seeing "isolated-vm" or Python errors during install? See troubleshooting.
Configure your credential
Whether you're on Cloud or self-hosted, credential setup is the same:
- Open any TokenSense node and click Create New Credential
- Set TokenSense Endpoint to
https://api.tokensense.io - Paste your TokenSense API key from app.tokensense.io/keys
- Click Test — you should see a success confirmation
Where do I get my API key?
Go to app.tokensense.io/keys and create a new key. If you haven't signed up yet, see Get Started.
What's my endpoint?
Your TokenSense endpoint is https://api.tokensense.io. The node handles path routing automatically.
Common credential errors
- 401 Unauthorized — your API key is invalid or expired. Generate a new one.
- 403 Forbidden — your key doesn't have access to the requested resource. Check project scope.
- Network error — check your n8n instance can reach
api.tokensense.io. See troubleshooting.
Add a TokenSense node to your workflow
Search for "TokenSense" in the n8n nodes panel. You'll see three options:
- TokenSense AI — general-purpose node for chat, image, embedding, audio, and model operations
- TokenSense Chat Model — sub-node for AI Agent workflows (attach as the language model)
- TokenSense AI Tool — for multi-agent orchestration
See Usage for details on each node type.