Claude Code Karma
Dashboard for monitoring claude code sessions.
What is Claude Code Karma?
Claude Code Karma is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to dashboard for monitoring claude code sessions.
Dashboard for monitoring claude code sessions.
This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Dashboard for monitoring claude code sessions.
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx claude-code-karmaConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use Claude Code Karma
Claude Code Karma is a local web dashboard for monitoring and analyzing Claude Code sessions, providing detailed visibility into session timelines, file operations, token usage, cost breakdowns, and tool consumption patterns across all your projects. It reads Claude Code session data from ~/.claude/ on your machine and presents it through a React frontend backed by a FastAPI server, with optional real-time session tracking via Python hooks. Developers who want to understand how Claude Code is spending tokens, which tools it calls most, and how sessions relate to GitHub issues, Linear tickets, or Jira tasks can use Karma to correlate AI activity with project work.
Prerequisites
- Python 3.9+ installed
- Node.js 18+ installed
- An active Claude Code installation with session data in ~/.claude/
- pip and npm available on your PATH
Clone the repository
Clone the Claude Code Karma repository to your local machine.
git clone https://github.com/JayantDevkar/claude-code-karma.git
cd claude-code-karmaStart the API backend
Install Python dependencies and launch the FastAPI backend server. It reads Claude Code session data from ~/.claude/ and serves it on port 8000.
cd api
pip install -e ".[dev]"
pip install -r requirements.txt
uvicorn main:app --reload --port 8000Start the frontend in a new terminal
Install Node.js dependencies and start the React development server. The dashboard will be accessible at http://localhost:5173.
cd frontend
npm install
npm run devOpen the dashboard
Navigate to http://localhost:5173 in your browser to access the session browser, analytics, and project views.
Install hooks for live session tracking (optional)
To enable real-time monitoring of active Claude Code sessions, install the provided Python hooks into your ~/.claude/hooks/ directory.
ln -s $(pwd)/hooks/*.py ~/.claude/hooks/Claude Code Karma Examples
Client configuration
Claude Code Karma runs as a standalone local web app, not as an MCP server injected into Claude Desktop. There is no claude_desktop_config.json entry needed — start the API and frontend separately.
{
"mcpServers": {}
}
// Claude Code Karma is a standalone dashboard, not an MCP server.
// Run the API on port 8000 and the frontend on port 5173 separately.
// Access the dashboard at http://localhost:5173Prompts to try
Dashboard workflows and features available in Claude Code Karma for session analysis.
- Navigate to the Analytics tab of a session to view cost breakdown, token usage, and cache hit rate.
- Use Ctrl+K (or Cmd+K) to open the command palette and search sessions by keyword or project name.
- Click the Tools section to see which MCP tools were called most frequently across all sessions.
- Link a session to a GitHub issue by pasting the issue URL in the session detail panel.
- Open the Live Sessions view to see real-time state of currently active Claude Code processes (requires hooks).Troubleshooting Claude Code Karma
The API backend starts but shows no sessions in the dashboard
The API reads session data from ~/.claude/. Ensure Claude Code has been run at least once and that session files exist in that directory. The backend user must have read access to ~/.claude/.
Live session tracking shows all sessions as STALE or ENDED immediately
Live session tracking requires the Python hooks from the hooks/ directory to be installed in ~/.claude/hooks/. Ensure the symlinks were created correctly with ln -s and that the hook files are executable. Restart Claude Code after installing hooks.
Frontend fails to connect to the API with CORS errors
Ensure the FastAPI backend is running on port 8000 (not a different port) before starting the frontend. If you changed the API port, update the VITE_API_URL environment variable in the frontend .env file to match.
Frequently Asked Questions about Claude Code Karma
What is Claude Code Karma?
Claude Code Karma is a Model Context Protocol (MCP) server that dashboard for monitoring claude code sessions. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install Claude Code Karma?
Follow the installation instructions on the Claude Code Karma GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with Claude Code Karma?
Claude Code Karma works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is Claude Code Karma free to use?
Yes, Claude Code Karma is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.
Claude Code Karma Alternatives — Similar Developer Tools Servers
Looking for alternatives to Claude Code Karma? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.
Ecc
★ 188.2kThe agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.
Javaguide
★ 155.8kJava 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发
Gemini CLI
★ 104.5kA secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in
Awesome MCP Servers
★ 87.3k⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.
MCP Servers
★ 86.0kModel Context Protocol Servers
CC Switch
★ 77.5kA cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io
Browse More Developer Tools MCP Servers
Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up Claude Code Karma in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use Claude Code Karma?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.