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
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.
What You'll Need
Set these up before or after installing:
Environment variable: CCU_CURRENCY
Environment variable: CCU_DECIMALS
Environment variable: CCU_USE_LIVE_API
Environment variable: CCU_LIVE_MIN_INTERVAL_SECONDS
Environment variable: CCU_BURN_WINDOW_MINUTES
Environment variable: CCU_PROJECT_GROUPING
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 GitHubFrom 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
Register it with your client. For Zed (settings.json):
{
"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 todist/server.mjs).extension.toml,Cargo.toml,src/lib.rs— a self-contained Zed extension that embeds and launches the server (an alternative to thenpxinstall 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
Git
Freeby Modelcontextprotocol · Developer Tools
Read, search, and manipulate Git repositories programmatically
Toleno
Freeby Toleno · Developer Tools
Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.
mcp-creator-python
Freeby mcp-marketplace · Developer Tools
Create, build, and publish Python MCP servers to PyPI — conversationally.
MarkItDown
Freeby Microsoft · Content & Media
Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption
MCP Marketplace
Freeby mcp-marketplace · Developer Tools
Search and install MCP servers from inside your AI client.
FinAgent
Freeby mcp-marketplace · Finance
Free stock data and market news for any MCP-compatible AI assistant.