ryoppippi/ccusage

Built by ryoppippi • 12,025 stars

What is ryoppippi/ccusage?

A CLI tool for analyzing Claude Code/Codex CLI usage from local JSONL files.

How to use ryoppippi/ccusage?

1. Install a compatible MCP client (like Claude Desktop). 2. Open your configuration settings. 3. Add ryoppippi/ccusage using the following command: npx @modelcontextprotocol/ryoppippi-ccusage 4. Restart the client and verify the new tools are active.

🛡️ Scoped (Restricted)

npx @modelcontextprotocol/ryoppippi-ccusage --scope restricted

🔓 Unrestricted Access

npx @modelcontextprotocol/ryoppippi-ccusage

Key Features

Native MCP Protocol Support

Real-time Tool Activation & Execution

Verified High-performance Implementation

Secure Resource & Context Handling

Optimized Use Cases

Extending AI models with custom local capabilities

Automating system workflows via natural language

Connecting external data sources to LLM context windows

ryoppippi/ccusage FAQ

Is ryoppippi/ccusage safe?

Yes, ryoppippi/ccusage follows the standardized Model Context Protocol security patterns and only executes tools with explicit user-granted permissions.

Is ryoppippi/ccusage up to date?

ryoppippi/ccusage is currently active in the registry with 12,025 stars on GitHub, indicating its reliability and community support.

Are there any limits for ryoppippi/ccusage?

Usage limits depend on the specific implementation of the MCP server and your system resources. Refer to the official documentation below for technical details.

Official Documentation

View on GitHub

./apps/ccusage/README.md

Global Ranking

8.5

Trust ScoreMCPHub Index

Based on codebase health & activity.

Manual Config

{ "mcpServers": { "ryoppippi-ccusage": { "command": "npx", "args": ["ryoppippi-ccusage"] } } }