Skip to main content
MCP server CX Codex

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

Install into Claude Code · Platform CLI All methods and platforms ↓
claude mcp add codeburn -- npx -y codeburn
Open on GitHub

What 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 codeburn to check AI spend in the terminal
  • Add CodeBurn MCP server with claude mcp add codeburn -- npx -y codeburn
  • Configure CodeBurn in the Cursor mcpServers block

How to install CodeBurn

Platform CLI

claude mcp add codeburn -- npx -y codeburn

Step 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.

Similar MCP servers

All MCP servers for Agent setup: memory, context, orchestration →

From the same set2

Project sponsors

Companies that keep this analytics open