Token MCP Server

Local-first dashboard + MCP server for Claude Code and Codex token usage. MCP-aware, multi-vendor, MIT.

Local serverstdio

What is the Token MCP Server?

Local-first dashboard + MCP server for Claude Code and Codex token usage. MCP-aware, multi-vendor, MIT.

What it actually does

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.

  • Your JSONL contains source code, prompts, and tool results. Token Meter never
  • No SDK to integrate, no proxy to configure for the free tier
  • The CLI and dashboard core are MIT licensed

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
usage_summaryDaily table of token counts, USD-equivalent cost, and call counts — broken down by day and model
recent_sessionsLatest sessions with paste-ready claude --resume / codex resume commands
session_toolsPer-tool breakdown inside a session: call count, total tokens, average latency, response size
refresh_dataRe-scans your local JSONL logs for new activity, then returns a fresh summary

How to install the Token MCP Server

{
  "mcpServers": {
    "token-meter": {
      "command": "npx",
      "args": ["-y", "@whdrnr2583/token-meter"]
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Example prompts to try

  • “Use Token to usage summary.”
  • “Use Token to recent sessions.”
  • “Use Token to session tools.”

Frequently asked questions

Local-first dashboard + MCP server for Claude Code and Codex token usage. MCP-aware, multi-vendor, MIT. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.