Skip to content
MCP server

CodeBurn

Itemize AI coding spend and plan quotas across 40+ tools, from local session files

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Windows
Runs
Locally
Version
0.9.28
Listing updated
3 days ago

About CodeBurn

CodeBurn is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

CodeBurn answers the question a monthly bill cannot: which model, project and task the money went to. It reads the session files that Claude Code, Codex, Cursor and dozens of other tools already write to disk, prices every token, and prints tables by tool, model, project and task, where task means what the agent was doing, such as coding, debugging or planning.

Running npx codeburn needs no account. The same engine also powers a macOS menu bar app, a desktop app, a browser view via codeburn web and a VS Code extension that works in Cursor, Windsurf, Antigravity and VSCodium. The site says it reads local session files only and sends nothing off the machine.

Beyond reporting, an optimize command lists spend that earns nothing, such as a file re-read every turn, an unused MCP server or an oversized CLAUDE.md, and can apply fixes with a backup and an undo. Spend can be matched to branches and pull requests, and plan usage is shown with time left in each window. It needs Node.js 22.15 or newer, and the registry entry exposes it over stdio.

Install

Run in a terminal

claude mcp add codeburn -- npx -y codeburn

Add to claude_desktop_config.json

{
  "mcpServers": {
    "codeburn": {
      "command": "npx",
      "args": [
        "-y",
        "codeburn"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "codeburn": {
      "command": "npx",
      "args": [
        "-y",
        "codeburn"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "codeburn": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "codeburn"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "codeburn": {
      "command": "npx",
      "args": [
        "-y",
        "codeburn"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "codeburn": {
      "command": "npx",
      "args": [
        "-y",
        "codeburn"
      ]
    }
  }
}

What it does

Cost breakdowns
Splits spend by tool, model, project, git branch and task.
Plan quota tracking
Shows live usage and time remaining per agent window.
Optimize findings
Finds wasteful patterns such as repeated file reads and unused MCP servers.
Reversible fixes
Applies config changes with backups and an undo command.
Pull request pricing
Attributes spend to branches and the PRs they produced.
Editor and menu bar apps
Offers a VS Code extension, macOS menu bar app and desktop dashboard.
Period comparison
Compares two date ranges to see whether a change cut costs.

Good for

  • Find which project burned most of this month's AI coding budget
  • Check how close a Claude or Codex plan is to its limit
  • Trim a CLAUDE.md or unused MCP servers that add tokens to every request
  • Price the cost of a feature by git branch
  • Compare spend before and after switching models

Pricing

Open source

Free and open source

Prices change. Check codeburn.app before you buy.

CodeBurn FAQ

Does it need an account?

No. npx codeburn works with no sign-up.

Does my data leave my machine?

The site says it reads local session files only and nothing is uploaded.

How many tools does it support?

42, according to the website.

What do I need to run it?

Node.js 22.15 or newer; install with npm, Homebrew or npx.

Is it free?

Yes, the site describes it as free and open source.

Is CodeBurn free?

Yes. CodeBurn is open source, so you can use and self-host it for free.

How do I add CodeBurn to Claude Code?

Run this command in your terminal: claude mcp add codeburn -- npx -y codeburn

What are the best alternatives to CodeBurn?

The closest alternatives to CodeBurn are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to CodeBurn

  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. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data