← Back to Claude Usage

Install Claude Usage

Pick your client, copy the command, done.

Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1

Prepare the server locally

Run this once before adding it to Claude Code.

git clone https://github.com/mvacaporale/claude-usage-mcp.git
cd claude-usage-mcp
uv sync
uv run playwright install chromium
2

Register it in Claude Code

claude mcp add claude-usage -- uv run --directory /path/to/claude-usage-mcp python server.py

Replace any placeholder paths in the command with the real path on your machine.

Available Tools (3)

Once configured, Claude Usage gives your AI agent access to:

get_claude_usageFetch usage data from the Claude dashboard
claude_loginOpen browser window for authentication
check_claude_authCheck if current session is authenticated

Try It Out

After setup, try these prompts with your AI agent:

Check my current Claude usage limits.
Am I still authenticated with Claude?
Log in to my Claude account to refresh my session.
What is my current weekly usage percentage for Sonnet?

Keep this setup from going cold

Save the docs, env vars, and workflow around Claude Usage in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup