Skip to content
MCP server

TokenBar

Check your remaining Claude Code, Codex and Copilot usage limits before a long task

Runs locallyStatus and history
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.mcpb

Add to claude_desktop_config.json

{
  "mcpServers": {
    "tokenbar": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ChaconLucas/tokenbar/releases/download/v0.5.3/TokenBar.mcpb"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "tokenbar": {
      "command": "npx",
      "args": [
        "-y",
        "https://github.com/ChaconLucas/tokenbar/releases/download/v0.5.3/TokenBar.mcpb"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ha MCP

    MCP server

    MCP server for managing and automating Home Assistant from AI assistants

    Runs locally
    • 8 tools
    • Open source
    • 7.9K GitHub stars
    • Productivity