Skip to main content
Glama
Chronova MCP Server

Chronova MCP Server

npm version Tests Release

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-server

Related MCP server: coros-mcp

Configuration

The server resolves your API key from multiple sources in priority order:

  1. Environment variable CHRONOVA_API_KEY

  2. Config file ~/.chronova.cfg — api_key under [settings]

  3. Config file ~/.wakatime.cfg — api_key under [settings] (WakaTime-compatible)

  4. 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/v1

Variable

Required

Default

Description

CHRONOVA_API_KEY

Yes*

—

Your Chronova API key (*or set in config file)

CHRONOVA_API_URL

No

https://chronova.dev/api/v1

Chronova API base URL

PORT

No

3001

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@chronova

Or 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_developer_context

Get user profile, subscription, GitHub status, org memberships

None

get_productivity_summary

Aggregated coding stats by time range

range (required), project (optional)

get_ai_insights

AI vs manual coding analytics

range (required)

get_recent_activity

Recent coding heartbeats with filters and pagination

date, start, end, project, language, editor, page, per_page (all optional)

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 oxfmt

Docker

docker build -t chronova-mcp .
docker run -e CHRONOVA_API_KEY=your-key -p 3001:3001 chronova-mcp

License

Proprietary

Available Tools

4 tools
get_ai_insightsA
Read-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_contextA
Read-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_summaryA
Read-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_activityA
Read-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

    A4.2/5.0

    Scored across 4 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityActive
    ResponsivenessLimited data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Provides 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
    • A
      license
      A
      quality
      A
      maintenance
      A 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.
      26
      126
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A comprehensive Model Context Protocol (MCP) server that integrates with the Cronlytic API to provide seamless cron job management through LLM applications like Claude Desktop.
      1
      MIT