Chronova MCP Server
This MCP server gives AI agents read-only access to your Chronova developer productivity data, including coding stats, activity heartbeats, and AI-assisted coding analytics.
Get developer context — retrieve your profile, coding statistics, subscription status, GitHub integration status, and organization memberships (no parameters needed).
Get productivity summary — view aggregated coding stats (total time, language/editor/project breakdowns) for named or custom time ranges, optionally filtered by project.
Get AI insights — analyze AI vs. manual coding: adoption timeline, contribution share, language-level comparisons, project AI dependency, and efficiency trends.
Get recent activity — browse paginated coding heartbeats filterable by date, date range, project, language, and editor/IDE.
Use flexible time ranges — named ranges (
today,last_7_days,last_30_days,last_3_months,last_6_months,last_year,all_time) or customYYYY-MM-DD_to_YYYY-MM-DDranges.Connect from any MCP client — works with Claude Code, Claude Desktop, Cursor, and OpenCode, with API key resolved via env var or config files.
Retrieves developer context including GitHub status and organization memberships via Chronova.
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., "@Chronova MCP Server get my productivity summary for last 7 days"
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.
MCP server that exposes Chronova developer productivity data to AI agents. Built on the Model Context Protocol, it lets tools like Claude Desktop, Cursor, and OpenCode query your coding stats, activity, and AI-assisted coding metrics.
Installation
# Run directly (stdio transport for MCP clients)
npx -y @chronova/mcp-server
# Or install globally
npm install -g @chronova/mcp-server
chronova-mcp-serverRelated MCP server: coros-mcp
Configuration
The server resolves your API key from multiple sources in priority order:
Environment variable
CHRONOVA_API_KEYConfig file
~/.chronova.cfg—api_keyunder[settings]Config file
~/.wakatime.cfg—api_keyunder[settings](WakaTime-compatible)Default: empty (requests will fail with 401)
Similarly, api_url is resolved from CHRONOVA_API_URL env var, then the config file's api_url key, then the default https://chronova.dev/api/v1.
Config files use INI format:
[settings]
api_key = waka_your-api-key-here
api_url = https://chronova.dev/api/v1Variable | Required | Default | Description |
| Yes* | — | Your Chronova API key (*or set in config file) |
| No |
| Chronova API base URL |
| No |
| Server listen port |
CLI flags override env vars: --port 3001, --api-url https://chronova.dev/api/v1, --help.
Usage with AI Clients
Claude Code
Install the plugin from this repository's marketplace:
claude plugin marketplace add nx-solutions-ug/chronova-mcp
claude plugin install chronova@chronovaOr inside a session: /plugin marketplace add nx-solutions-ug/chronova-mcp, then /plugin install chronova@chronova.
The plugin runs npx -y @chronova/mcp-server@latest and reads your API key from CHRONOVA_API_KEY, ~/.chronova.cfg or ~/.wakatime.cfg (see Configuration). If you already registered the server with claude mcp add, remove that entry so the tools are not listed twice.
Claude Desktop
Add to claude_desktop_config.json:
{
"mcpServers": {
"chronova": {
"command": "npx",
"args": ["-y", "@chronova/mcp-server"],
"env": {
"CHRONOVA_API_KEY": "your-api-key"
}
}
}
}Cursor
Add to .cursor/mcp.json:
{
"mcpServers": {
"chronova": {
"command": "npx",
"args": ["-y", "@chronova/mcp-server"],
"env": {
"CHRONOVA_API_KEY": "your-api-key"
}
}
}
}OpenCode
Add to opencode.json under mcp:
{
"mcp": {
"chronova": {
"type": "local",
"command": ["npx", "-y", "@chronova/mcp-server"],
"enabled": true,
"env": {
"CHRONOVA_API_KEY": "your-api-key"
}
}
}
}Tools
Tool | Description | Parameters |
| Get user profile, subscription, GitHub status, org memberships | None |
| Aggregated coding stats by time range |
|
| AI vs manual coding analytics |
|
| Recent coding heartbeats with filters and pagination |
|
Named ranges: today, last_7_days, last_30_days, last_3_months, last_6_months, last_year, all_time. Custom: YYYY-MM-DD_to_YYYY-MM-DD.
Development
bun install # Install dependencies
bun run dev # Watch mode
bun run test # Run tests
bun run build # Build dist/ (bun build + tsc declarations)
bun run type-check # Type check only
bun run lint # Lint with oxlint
bun run format # Format with oxfmtDocker
docker build -t chronova-mcp .
docker run -e CHRONOVA_API_KEY=your-key -p 3001:3001 chronova-mcpLicense
Proprietary
Available Tools
4 toolsget_ai_insightsARead-only
Get AI-assisted coding analytics including adoption timeline (AI vs manual coding over time), contribution share (percentage of AI vs manual work), human vs AI comparison by language, project-level AI dependency, and efficiency trends.
Inputs: range (required).
get_developer_contextARead-only
Get the authenticated user's developer profile including coding statistics, subscription status, GitHub integration status, and organization memberships. No parameters required — uses the configured API key.
Inputs: no named parameters.
get_productivity_summaryARead-only
Get aggregated coding productivity statistics for a time range. Returns total coding time, language breakdown, editor breakdown, and project breakdown.
Inputs: range (required), project.
get_recent_activityARead-only
Get recent coding heartbeats (activity events). Returns paginated results — use 'page' and 'per_page' parameters to navigate through large result sets. The response includes 'total' count and pagination metadata.
Inputs: end, date, page, start, +4 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool targets a distinct area: AI insights, developer profile, productivity aggregates, and raw activity events. The descriptions clearly differentiate the data returned, leaving no ambiguity about which tool to select.
All tool names follow a consistent get_<object> pattern with clear snake_case naming. The verbs and nouns are uniform, making the API predictable and easy to navigate.
With only 4 tools, the server is tightly scoped to read-only coding analytics. Each tool covers a distinct and necessary data view without unnecessary bloat or redundancy.
The set covers the major analytics surfaces: AI insights, user context, productivity summaries, and raw activity logs. Minor gaps like team-level analytics or detailed project history could exist, but core personal coding analytics needs are well served.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Real-time chat hub for AI agents — Claude Code, Cursor, Cline, Codex over MCP or REST.
Real-time chat for AI agents. Claude Code, Cursor, Cline and Codex join channels over MCP.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceProvides access to WakaTime coding analytics data through MCP tools. Enables querying coding stats, activity summaries, project lists, and time tracking information from your WakaTime account.MIT
- AlicenseAqualityAmaintenanceA Model Context Protocol (MCP) server that fetches sleep, HRV, and training data from the unofficial Coros API and exposes them to AI assistants like Claude, enabling natural language queries about fitness metrics and workout management.26126MIT

Cronlytic MCP Serverofficial
AlicenseNot gradedqualityDmaintenanceA comprehensive Model Context Protocol (MCP) server that integrates with the Cronlytic API to provide seamless cron job management through LLM applications like Claude Desktop.1MIT- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that connects to ActivityWatch, allowing LLMs like Claude to interact with your time tracking data.82 PyPI5MIT