Chronova MCP Server

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

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.

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, --help.

Usage with AI Clients

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

npm run dev          # Watch mode
npm test             # Run tests
npm run build        # Compile TypeScript
npm run type-check   # Type check only

Docker

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

License

Proprietary