chronova-mcp

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

Config files use INI format:

[settings]
api_key = waka_your-api-key-here
api_url = https://chronova.dev/api/v1

CLI flags override env vars: --port 3001, --api-url https://chronova.dev/api/v1, --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

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