# CodeBurn

> CodeBurn is an open-source MCP server for developer tools. Itemize AI coding spend and plan quotas across 40+ tools, from local session files. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, macOS, Windows, Linux, vscode
- **Website:** https://codeburn.app
- **Repository:** https://github.com/getagentseal/codeburn
- **MCP Registry name:** io.github.getagentseal/codeburn
- **Categories:** developer tools, analytics and data
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add codeburn -- npx -y codeburn
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "codeburn": {
      "command": "npx",
      "args": [
        "-y",
        "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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.

---
Source: https://ai-powered.com/mcp/codeburn
