Claude Code Usage MCP Server

by wheelbarrel00 Your server? Claim it

local only

Claude Code Usage runs on your own machine — the client starts it, so there is no endpoint to ping. 44 installs a week from npm. Last commit 22 Jun 2026.

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

Installs per day peak 9 · avg 4 · +55% w/w

a month agotoday

Installs / week

npm · claude-code-usage-mcp

Stars

0 open issues

22 Jun 2026

Last commit

no releases in 90 days

MIT

License

TypeScript

Nothing serious here today

Today is the operative word: we check Claude Code Usage every 15 minutes and re-read its code on every release. Watch it and you find out the day that stops being true.

Connect this server

This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.

Claude Code Claude Desktop Codex Cursor VS Code

run in your terminal

claude mcp add claude-code-usage -- npx -y claude-code-usage-mcp

~/Library/Application Support/Claude/claude_desktop_config.json

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

~/.codex/config.toml

[mcp_servers.claude-code-usage]
command = "npx"
args = ["-y", "claude-code-usage-mcp"]

.cursor/mcp.json

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

.vscode/mcp.json

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

Alternatives to Claude Code Usage

same job, measured the same way

Tokmeter — AI Agent Usage & Cost

by sriinnu

Tokens and cost for Claude Code, Codex and 22 more AI coding agents, from local session files.

1 212 installs/wk local only

seatledger

by agentwares

Local ledger of Claude Code and Codex tokens, API-equivalent cost, limits and token-rate changes.

79 installs/wk local only

Token Meter

by whdrnr2583-cmd

Local-first dashboard + MCP for Claude Code and Codex token usage. Per-MCP/tool breakdown.

130 installs/wk local only

AI Usage

by mohitbansal321

Reports real token usage and cost from Claude Code and OpenCode data. Nothing leaves your machine.

379 installs/wk local only

TokenBar

by chaconlucas

AI usage limits (Claude Code, Codex, Copilot, Windsurf): check budget and time until reset.

local only

Usage Planner

by itsodeleo

Plan OpenAI Codex usage from local quota, banked resets and extra-reset forecasts.

175 installs/wk local only

Codex4ever

by itsodeleo

Plan OpenAI Codex usage from local quota, banked resets and extra-reset forecasts.

108 installs/wk local only

SkillFM Claude Code Token Usage

by ericm1018

Claude Code token usage, cost visibility, and SkillFM Beacon AI health checks for MCP agents.

43 installs/wk local only

Claude Code Usage — questions

Answers built from our own checks of this server.

Why is there no uptime for Claude Code Usage?

Claude Code Usage runs on your own machine over stdio — there is no network address to reach, so uptime cannot be measured for it by anyone. What can be measured is adoption: the npm package claude-code-usage-mcp was installed 44 times last week.

How do I connect Claude Code Usage?

Copy the ready config from this page. We generate it for Claude Code, Claude Desktop, Codex, Cursor and VS Code, each in the form that client actually reads. It runs locally, so the command pulls claude-code-usage-mcp straight from npm; nothing to host, nothing to sign up for.

How many people use Claude Code Usage?

The npm package claude-code-usage-mcp was installed 44 times in the last week. Week over week that is +55%. We show installs rather than GitHub stars on purpose: a star is a bookmark, an install is someone actually running it.

Is Claude Code Usage open source?

Yes — it is published under the MIT licence, written in TypeScript and 0 stars on GitHub. The source link is on this page, so you can read exactly what it does with your data before you connect it.