TokenBar
Check your remaining Claude Code, Codex and Copilot usage limits before a long task
- Pricing
- Open source
- Platforms
- macOS, Windows, Linux
- Runs
- Locally
- Version
- 0.5.3
- Listing updated
- 2 days ago
About TokenBar
TokenBar is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.
An agent that is about to start a long job can ask this server how much of its 5-hour and 7-day allowance is left and when it resets, rather than discovering the cap mid-task. The registry entry names Claude Code, Codex, Copilot and Windsurf, and the project page also lists Cursor, Gemini, Kiro, GLM, Kimi, MiniMax and Amp, plus any tool that writes a small JSON file.
The MCP server is one part of a wider app. A desktop component collects the numbers and exposes a local JSON API on localhost port 41777, a CLI with a shell-prompt mode, and webhooks that fire at 80%, 95% and on reset to Slack, Discord, Home Assistant or any URL. Phones and watches only show what the computer sends over Wi-Fi.
Apps cover Mac, Windows, Linux, iPhone, Android, Apple Watch and Wear OS, with extras for VS Code, Raycast and Stream Deck. The README notes the Mac app is not yet notarized, so the first launch may need an override.
Install
Run in a terminal
claude mcp add tokenbar -- npx -y https://github.com/ChaconLucas/tokenbar/releases/download/v0.5.3/TokenBar.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"tokenbar": {
"command": "npx",
"args": [
"-y",
"https://github.com/ChaconLucas/tokenbar/releases/download/v0.5.3/TokenBar.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"tokenbar": {
"command": "npx",
"args": [
"-y",
"https://github.com/ChaconLucas/tokenbar/releases/download/v0.5.3/TokenBar.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"tokenbar": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/ChaconLucas/tokenbar/releases/download/v0.5.3/TokenBar.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"tokenbar": {
"command": "npx",
"args": [
"-y",
"https://github.com/ChaconLucas/tokenbar/releases/download/v0.5.3/TokenBar.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"tokenbar": {
"command": "npx",
"args": [
"-y",
"https://github.com/ChaconLucas/tokenbar/releases/download/v0.5.3/TokenBar.mcpb"
]
}
}
}What it does
- Budget check for agents
- Lets Claude Code, Codex and Cursor read remaining budget and reset time before a long task.
- Local JSON API
- Serves usage on localhost:41777 to any script or app on the machine.
- CLI
- Prints usage as JSON, for scripts, or as a shell prompt segment.
- Threshold webhooks
- Sends events at 80%, 95% and reset.
- Many displays
- Shows limits on desktop, phone, watch, VS Code, Raycast and Stream Deck.
Good for
- Have an agent check its budget before a long refactor
- Show remaining usage in your shell prompt
- Get a Slack alert at 80% of a limit
- Watch limits on a phone or watch
Pricing
Open source
Pricing not published on the site
Prices change. Check chaconlucas.github.io before you buy.
TokenBar FAQ
Which AI tools does it track?
Claude Code, Codex, Copilot and Windsurf per the registry; the site also lists Cursor, Gemini, Kiro, GLM, Kimi, MiniMax and Amp.
How do I install the MCP server?
Install the CLI first, then add the server to your tool; Cursor and VS Code have one-click installs and Claude Desktop uses the .mcpb bundle.
Does it run locally?
Yes. The server uses stdio and usage is served from your own computer.
Is the Mac app notarized?
Not yet, per the README, so macOS may block a browser-downloaded copy.
Is TokenBar free?
Yes. TokenBar is open source, so you can use and self-host it for free.
How do I add TokenBar to Claude Code?
Run this command in your terminal: claude mcp add tokenbar -- npx -y https://github.com/ChaconLucas/tokenbar/releases/download/v0.5.3/TokenBar.mcpb
What are the best alternatives to TokenBar?
The closest alternatives to TokenBar are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.
Alternatives to TokenBar

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Codebase Memory
MCP serverLocal MCP server that builds a code knowledge graph for AI coding agents
Runs locally- Open source
- 48.7K GitHub stars
- Knowledge and memory

GitHub
MCP serverOfficial MCP server connecting AI assistants to GitHub repos, issues and workflows
Not checked yet- Remote
- Open source
- 34.5K GitHub stars
- Developer tools

Serena MCP: the IDE for your agent
MCP serverMCP toolkit giving coding agents symbol-level code retrieval and editing
Runs locally- Open source
- 31.5K GitHub stars
- Developer tools

XERJ
MCP serverLocal search engine for AI agents with cited answers over your code and docs
Runs locally- Open source
- 19.2K GitHub stars
- Knowledge and memory

Ha MCP
MCP serverMCP server for managing and automating Home Assistant from AI assistants
Runs locally- 8 tools
- Open source
- 7.9K GitHub stars
- Productivity