CodeBurn
Itemize AI coding spend and plan quotas across 40+ tools, from local session files
- 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 codeburnAdd to claude_desktop_config.json
{
"mcpServers": {
"codeburn": {
"command": "npx",
"args": [
"-y",
"codeburn"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"codeburn": {
"command": "npx",
"args": [
"-y",
"codeburn"
]
}
}
}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

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

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data