Mmcp.market

Token Meter MCP server

by whdrnr2583-cmd·io.github.whdrnr2583-cmd/token-meter·v0.1.17·1 stars
No reviews yet

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

C66/100grade C
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
C66/100

full report

Adoption
Growing

1 stars119 downloads/wk

Reviews

Write one

Nobody has reviewed Token Meter yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Token Meter tools (4)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • recent_sessions

    List recently-active Claude Code / Codex sessions with ready-to-paste resume commands.

  • refresh_data

    Re-scan local Claude Code / Codex JSONL for new activity. Run before other tools for up-to-the-minute numbers.

  • session_tools

    Per-session MCP / built-in tool breakdown: call counts, response sizes, average latency. Debug a slow/expensive session.

  • usage_summary

    What you spent, where it went, and what was slow — Claude Code + Codex. API-equivalent estimate, local data only. Table by day × models (ccusage-style) + advisory narrative. scope defaults to "auto" (filter to current platform); pass "all" to see everything. insights=true adds heuristic tips.

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

1 high
  • Code scan23 source files scanned13/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 71 days ago12/15
  • Maintainer identityregistry namespace matches repository owner6/10

Findings (1)

  • highShell command built from a string (injection risk)exec.shell-concat
    dist/install-mcp.js: …cp`, }; } try { execSync(`claude mcp add ${MCP_SERVER_NAME} -- npx -y ${MCP_PACKAGE} mcp`, { stdio: 'pipe', enco…
Overall 66/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

Install Token Meter in Claude Code, Cursor or VS Code

Runs npx -y @whdrnr2583/token-meter on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add token-meter -- npx -y @whdrnr2583/token-meter
Add to Cursor

What the publisher says

From the Token Meter repository's README, as published. We do not edit it. Read it on GitHub

Token Meter

Track Claude Code, Codex & Cursor token usage and cost locally — no account, no cloud.

One local dashboard for your Claude Code and Codex token usage.

Free, MCP-aware, MIT-licensed core.

npm: @whdrnr2583/token-meter · GitHub: whdrnr2583-cmd/token-meter · Site: token-meter.dev

Token Meter parses the JSONL files that Claude Code and Codex already write to disk and turns them into a real dashboard: cost per project, per model, per MCP tool, per hour. Your data never leaves your machine.

Run your first audit

npx -y @whdrnr2583/token-meter audit

Scans your ingested Claude Code + Codex history for expensive sessions, oversized tool responses, slow tools, repeated calls, and cache waste, ranked by cost and confidence. Runs entirely against your local SQLite database — same local-first, no-cloud processing as the rest of Token Meter. Add --json for machine-readable output; see docs/audit.md for the full flag list and JSON schema.

When to use this

Use Token Meter if you:

  • want to know how many tokens and dollars your Claude Code or Codex sessions are costing — broken down by project, model, and MCP tool
  • are on a flat-fee plan (Claude Max, etc.) and want to see what the equivalent API cost would be
  • want to find which MCP server or tool is eating the most tokens, or which hour of the day is most expensive
  • want to resume a recent session and need the claude --resume / codex resume command handy
  • want all of the above offline, with no account and nothing uploaded

Not a fit if you need billing-grade numbers validated against your Anthropic or OpenAI invoice — Token Meter computes estimates from local JSONL files only.

MCP tools

When Token Meter is wired as an MCP server (install-mcp all), four tools become available to your AI assistant:

All four are read-only. No data leaves your machine.

Example prompts

Copy-paste any of these into Claude Code or Cursor after installing the MCP server:

Show me my token usage and cost for the last 7 days.
List my recent sessions so I can pick one to resume.
Show the tool breakdown for my most recent session — which tool used the most tokens?
Refresh token-meter data, then tell me which model cost the most this week.
Which hour of the day am I spending the most tokens on?

Quick start

npx @whdrnr2583/token-meter ingest        # scan ~/.claude/projects + ~/.codex/sessions
npx @whdrnr2583/token-meter stats 30      # CLI summary for last 30 days
npx @whdrnr2583/token-meter serve         # http://localhost:8765 dashboard
npx @whdrnr2583/token-meter mcp           # run as an MCP server for Claude Code / Cursor

The package is published under an npm scope (@whdrnr2583/) because the

bare token-meter name collides with an existing similar name on npm. The

CLI binary is still called token-meter after install.

Connect Token Meter to your AI tool (MCP)

One command registers Token Meter with every supported client on your machine:

npx -y @whdrnr2583/token-meter install-mcp all

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Token Meter: common questions

Is Token Meter MCP server safe?
With care: it is graded C, so read the findings first (66/100). Read the Token Meter safety report
How do I install Token Meter?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Token Meter need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Token Meter maintained?
The last commit was 72 days ago (2026-07-18). The latest release is v0.1.17.

More from whdrnr2583-cmd →