# CodeBurn MCP server

> Analyzes AI coding spend, token usage, and plan quotas across tools like Claude Code, Cursor, and Codex by reading local session files.

- Repository: https://github.com/getagentseal/codeburn
- Page: https://hostedmcp.org/servers/getagentseal/codeburn
- Official: yes
- Transport: stdio
- Stars: 11798
- License: MIT
- Latest version: 0.9.28

## Install

### Claude Code

```sh
claude mcp add codeburn -- npx -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"
      ]
    }
  }
}
```

### VS Code CLI

```sh
code --add-mcp '{"name":"codeburn","type":"stdio","command":"npx","args":["-y","codeburn"]}'
```

### Claude Desktop (`claude_desktop_config.json`)

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

### Codex

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

### Codex config.toml (`~/.codex/config.toml`)

```toml
[mcp_servers.codeburn]
command = "npx"
args = ["-y", "codeburn"]
```

### Gemini CLI

```sh
gemini mcp add -s user codeburn npx -- -y codeburn
```

### Gemini settings.json (`~/.gemini/settings.json`)

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

## FAQ

### How does CodeBurn track my spending?

It reads the session files that tools like Claude Code, Codex, and Cursor write to your disk, which contain every token and model call.

### Do I need to create an account to use CodeBurn?

No, there is no account or sign-up required to use the tool.

### Can CodeBurn help me reduce my AI costs?

Yes, the optimize command identifies things that cost tokens without providing value, such as unnecessary files or unused MCP servers, and can automatically apply fixes.

### Does the MCP server send my data to a remote server?

No, the MCP server reads local files on your disk and makes no network calls of its own.