claude-usage-meter

Fetch Claude API usage limits and remaining quota via direct API calls.

2|Updated Jan 30, 2026
One-click install
npx skills add https://github.com/tankygranny05/agent-box --skill claude-usage-meter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: claude-usage-meter
Source: https://github.com/tankygranny05/agent-box/tree/main/agent-box/seed/codex-skills/claude-usage-meter
Command: npx skills add https://github.com/tankygranny05/agent-box --skill claude-usage-meter

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires requests, and includes scripts (resource) components.

What problem does it solve?

This Skill allows users to programmatically check their Claude API usage limits and remaining quota, providing visibility into their consumption and preventing unexpected service interruptions.

Core Features & Use Cases

  • API Usage Fetching: Retrieves current usage statistics for different time windows (e.g., 5-hour, 7-day).
  • Quota Monitoring: Displays utilization percentages and when quotas reset.
  • OAuth Token Management: Includes scripts to refresh and manage OAuth tokens necessary for API access.
  • Use Case: A developer integrating Claude API into an application can use this Skill to monitor daily usage and ensure they stay within their allocated limits, avoiding rate limiting.

Quick Start

Run the script to fetch your current Claude API usage details.

Frequently Asked Questions about claude-usage-meter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I monitor Claude API usage and rate limits programmatically?

You can programmatically monitor Claude API usage by executing a script that fetches current usage statistics and remaining quota via direct API calls. It handles OAuth token refresh automatically to retrieve authenticated consumption data and prevent unexpected service interruptions.

How do I check remaining Claude API quota before hitting rate limits?

Check remaining Claude API quota by fetching current usage statistics that display utilization percentages and reset times for different time windows. This visibility allows developers to track consumption and avoid hitting rate limits during application integration.

Does the Claude API usage monitor handle OAuth token refresh automatically?

Yes, the Claude API usage monitor includes scripts that handle OAuth token refresh and conversion automatically. This ensures continuous authenticated access to usage statistics without manual token management for each API call.

What time windows can I track when monitoring Claude API consumption?

You can track Claude API consumption across multiple time windows, including 5-hour and 7-day intervals. The monitor retrieves usage statistics for these periods to display utilization percentages and when specific quotas reset.

Do I need the requests library to fetch Claude API usage limits?

Yes, you need the requests library installed to fetch Claude API usage limits, as the script depends on it to execute direct API calls. This Python dependency handles the HTTP requests to retrieve usage statistics and quota data.

Why am I getting rate limited on the Claude API and how can I track it?

You get rate limited when API consumption exceeds allocated quota for a specific time window. You can track it by fetching current usage statistics to view utilization percentages and exact quota reset times, preventing unexpected service interruptions.