Is ClaudeCodeUsageTool free?

Yes, ClaudeCodeUsageTool is free to use.

How do I install ClaudeCodeUsageTool?

ClaudeCodeUsageTool is a local plugin. Install it using npm package: claude-code-usage-mcp and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

What credentials does ClaudeCodeUsageTool need?

ClaudeCodeUsageTool requires the following credentials or environment variables: CCU_CURRENCY, CCU_DECIMALS, CCU_USE_LIVE_API, CCU_LIVE_MIN_INTERVAL_SECONDS, CCU_BURN_WINDOW_MINUTES, CCU_PROJECT_GROUPING, CLAUDE_CONFIG_DIR. You can find setup instructions on the server detail page.

What AI apps work with ClaudeCodeUsageTool?

ClaudeCodeUsageTool uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

ClaudeCodeUsageTool MCP Server

by Wheelbarrel00

Developer ToolsUse Caution4.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

Claude Code token usage, cost, and plan limits from local logs and Anthropic's usage API.

About

Claude Code token usage, cost, and plan limits from local logs and Anthropic's usage API.

Security Report

4.2

Use Caution4.2High Risk

This MCP server provides Claude Code usage tracking and cost analysis through local log parsing and Anthropic's OAuth API. The code is well-structured with appropriate authentication, proper token handling via environment variables, and permissions that align with its stated purpose. Minor code quality issues and broad exception handling present low-risk findings. Supply chain analysis found 5 known vulnerabilities in dependencies (0 critical, 4 high severity). Package verification found 1 issue.

3 files analyzed · 9 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

File System Read

Reads files on your machine. Normal for tools that analyze or process local data.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

USDOptional

Environment variable: CCU_CURRENCY

2Optional

Environment variable: CCU_DECIMALS

trueOptional

Environment variable: CCU_USE_LIVE_API

180Optional

Environment variable: CCU_LIVE_MIN_INTERVAL_SECONDS

15Optional

Environment variable: CCU_BURN_WINDOW_MINUTES

gitOptional

Environment variable: CCU_PROJECT_GROUPING

~/.claudeOptional

Environment variable: CLAUDE_CONFIG_DIR

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-wheelbarrel00-claude-code-usage": {
      "env": {
        "CCU_CURRENCY": "your-ccu-currency-here",
        "CCU_DECIMALS": "your-ccu-decimals-here",
        "CCU_USE_LIVE_API": "your-ccu-use-live-api-here",
        "CLAUDE_CONFIG_DIR": "your-claude-config-dir-here",
        "CCU_PROJECT_GROUPING": "your-ccu-project-grouping-here",
        "CCU_BURN_WINDOW_MINUTES": "your-ccu-burn-window-minutes-here",
        "CCU_LIVE_MIN_INTERVAL_SECONDS": "your-ccu-live-min-interval-seconds-here"
      },
      "args": [
        "-y",
        "claude-code-usage-mcp"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Claude Code Usage

An MCP server that surfaces your Claude Code token usage, estimated cost, and plan-limit status in any MCP client (Zed, Claude Desktop, Cursor, and others). It reads Claude Code's own logs (~/.claude/projects/**/*.jsonl) and Anthropic's usage API, then exposes the data as tools the agent can call.

Published on npm as claude-code-usage-mcp and in the official MCP registry as io.github.wheelbarrel00/claude-code-usage.

What you get

Two tools:

get_claude_usage — today's cost and tokens, 5-hour and weekly plan-limit utilization (with reset times and a pace projection), recent burn rate, current context-window fill, and pay-as-you-go extra usage.
get_usage_breakdown — usage grouped by model, project, session, or git branch, or over time (daily this month / monthly all-time).

Ask the agent things like "what's my Claude usage right now?" or "break down my Claude spend by project this month." MCP tools are queried on demand — there's no persistent status-bar display.

Install

npx -y claude-code-usage-mcp

{
  "context_servers": {
    "claude-code-usage": {
      "command": "npx",
      "args": ["-y", "claude-code-usage-mcp"]
    }
  }
}

For Claude Desktop (claude_desktop_config.json), use the same command under "mcpServers" instead of "context_servers".

Requirements

An authenticated Claude Code install — the server reads ~/.claude/.credentials.json and ~/.claude/projects, the same files the CLI writes.

Configuration

Optional environment variables:

Variable	Default	Meaning
`CCU_CURRENCY`	`USD`	ISO currency code for cost formatting.
`CCU_DECIMALS`	`2`	Decimal places for cost figures.
`CCU_USE_LIVE_API`	`true`	Fetch live limits from Anthropic; falls back to the on-disk cache.
`CCU_LIVE_MIN_INTERVAL_SECONDS`	`180`	Minimum seconds between live usage requests.
`CCU_BURN_WINDOW_MINUTES`	`15`	Trailing window for the burn-rate calculation.
`CCU_PROJECT_GROUPING`	`git`	`git`, `folder`, or `flat` grouping for the project breakdown.
`CLAUDE_CONFIG_DIR`	`~/.claude`	Override the Claude Code config directory.

How it works

Live plan limits come from api.anthropic.com/api/oauth/usage using the OAuth token already on disk; the access token is refreshed in memory only, so a running Claude Code session is never logged out. Token and cost figures are parsed from the local session logs.

Repository layout

mcp-server/ — the MCP server (TypeScript, bundled to dist/server.mjs).
extension.toml, Cargo.toml, src/lib.rs — a self-contained Zed extension that embeds and launches the server (an alternative to the npx install above).

Build from source

cd mcp-server
npm install
npm run build      # bundles to dist/server.mjs
node dist/server.mjs --selftest

Zed extension (self-contained, no npm needed)

The Zed extension embeds the bundled server and launches it with Zed's own Node. Build the server first, install rustup and the WebAssembly target (rustup target add wasm32-wasip1), then in Zed open Extensions → Install Dev Extension and select this repository's root folder.

License

MIT

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

ClaudeCodeUsageTool MCP Server

About

Security Report

Findings (9)Action required

Permissions Required

What You'll Need

How to Install

Documentation

Claude Code Usage

What you get

Install

Requirements

Configuration

How it works

Repository layout

Build from source

Zed extension (self-contained, no npm needed)

License

Reviews

No reviews yet

More Developer Tools MCP Servers

Fetch

Toleno

mcp-creator-python

MarkItDown

FinAgent

mcp-creator-typescript