CodeBurn — Claude Code MCP server: what it does, how to install
CodeBurn MCP server breaks down AI coding spend, tokens, and quotas from local session files. Runs during cost audits.
MIT ★ 11,881 updated 2026-10-21
claude mcp add codeburn -- npx -y codeburnWhat CodeBurn does
The tool reads session logs generated by Claude Code, Codex, Cursor, and other tools to calculate exact costs by project, model, and task. It processes files directly on disk without requiring an account or sign-up.
Execution requires Node.js 22.15 or newer. The dashboard displays spending tables broken down by git branches and agent activities like debugging or coding.
The system aggregates data from multiple surfaces including the terminal, desktop app, and menu bar popover using the same local session records.
What it helps with
- calculate token costs per project and model
- track AI spending by git branch
- break down agent expenses by task type
- compare costs across different date ranges
Example prompts for the agent
- Run
npx codeburnto check AI spend in the terminal - Add CodeBurn MCP server with
claude mcp add codeburn -- npx -y codeburn - Configure CodeBurn in the Cursor
mcpServersblock
How to install CodeBurn
Platform CLI
claude mcp add codeburn -- npx -y codeburnPlatform CLI
codex mcp add codeburn -- npx -y codeburnConfig file
{
"mcpServers": {
"codeburn": {
"command": "npx",
"args": [
"-y",
"codeburn"
]
}
}
}Config file
{
"servers": {
"codeburn": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"codeburn"
]
}
}
}Platform CLI
gemini mcp add codeburn npx -y codeburnStep by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about CodeBurn
How to install CodeBurn in Claude Code?
Run the command claude mcp add codeburn -- npx -y codeburn in your terminal.
What does CodeBurn do?
CodeBurn reads local AI coding session files to calculate token usage and present detailed spend breakdowns by project, model, branch, and task.
What is needed to run CodeBurn?
Node.js 22.15 or newer is required to execute the tool and parse local session logs.