Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@claude-usage how much rate-limit headroom do I have left?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Know how close your Claude account is to its limits — in your terminal, inside Claude Code, and on your phone and wrist.
The open-source claude-usage service, plus the Usage Deck dashboards for iPhone, Apple Watch
and Android.
Works with Claude Code. Not affiliated with, endorsed by, or sponsored by Anthropic.
https://github.com/user-attachments/assets/4150c424-cedb-4235-abfb-f23ec402f18e
https://github.com/user-attachments/assets/0f93ea22-bf9a-4794-9a2e-3a686739377d
claude-usage is the small background service at the heart of Usage Deck, for macOS and Linux. It reads the same usage
numbers /usage shows, adds up the tokens your Claude Code sessions spend, and puts both
where you need them:
Inside Claude Code — a one-line warning when a window is getting tight, and MCP tools a session can call to check its own budget and slow down before it hits the wall.
In your terminal — claude-usage status, token totals by project or model, and pause or
resume any running session.
On your phone, watch and desk — the free Usage Deck apps show every account's rings, every live session and its burn rate, and pause or freeze sessions with a tap.
It never sends your data anywhere: the only outside calls are Anthropic's own usage endpoint and GitHub, to check for signed updates. Phones reach it over your own Wi-Fi with HTTPS pinned to the daemon's certificate.
You need Node 20+ (22 or later to build without engine warnings) and Claude Code signed in on the machine.
git clone https://github.com/drmuzikbpn/usage-deck.git
cd usage-deck
npm ci && npm run build
node bin/claude-usage installinstall explains each change and asks before making it. It starts the background service,
adds the Claude Code hook and MCP server, and puts claude-usage on your PATH. You can delete
the checkout afterwards: the service keeps itself up to date from signed GitHub releases.
Check it worked:
claude-usage statusRemove everything again with claude-usage uninstall.
Related MCP server: claudeusage-mcp
Get the app:
iPhone + Apple Watch — Usage Deck, free on the App Store (in App Review now; the link goes here once it is live). The watch app comes with it. No computer yet? Tap Try the demo.
Android — a dedicated-device dashboard, not an everyday phone app: it is built to
run as the kiosk launcher on a spare phone on your desk or wall (Device Owner, so it can
stay pinned on screen and update itself). That is why it asks for location (Android
requires it to read the Wi-Fi network name) and permission to install packages (its own
signed updates). Set-up: device setup guide;
APK from the deck- releases.
On each machine you want to see, turn on LAN access (an interactive install offers it), then pair:
claude-usage configure lan on # once, if you skipped it during install
claude-usage pairScan the QR code it shows. That's it — the code works once and expires in five minutes, and the token it unlocks never appears on screen.
Your phone or watch must be on the same network as the computer running Claude Code.
Remote monitoring talks straight to that computer over your local network; there is no
cloud relay. To check in from anywhere, put both on a private VPN such as
Tailscale (free for personal use): run
claude-usage install --tailscale and pair again. See
Away from home.
It only works with Claude Code for now. Limits come from your Claude Code sign-in and session data from Claude Code's own files. Support for more tools is coming.
Landscape is where it shines: stand the phone on your desk next to the keyboard.
iPhone | Apple Watch | Android desk phone |
Portrait works too | Projects at a glance | A wall or desk dashboard in landscape |
All screenshots use made-up demo data.
Every command, the hook, MCP tools, status line, configuration, auto-update, troubleshooting | |
What the token protects, pinning, signed releases, how to report a vulnerability | |
Every endpoint, error envelope and the live event stream, for building your own client | |
Source on the | |
Source on the | |
How to build, test and send a change |
MIT © 2026 Even Seal Productions — see LICENSE. Claude and Claude Code are trademarks of Anthropic.
This server cannot be deployed
Read-only analytics for Convex apps, queryable via MCP from Claude, Cursor, and other clients.
Analytics for MCP servers. Query your tool calls, first-call success, retries and schema cost.
Discover Frontier inference capabilities and read sanitized usage through read-only tools.
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
