🚀 wakatime-mcp

An MCP server that exposes WakaTime summary tools over stdio. It proxies the WakaTime Summaries API with your API key and returns raw JSON for clients to parse as needed.

📋 Summary

Key features:

• 🔐 Uses WAKATIME_API_KEY for authentication
• 📊 Exposes daily summaries and today’s summary
• 📦 Runs via npx (no install required)

🚀 Quick Start (npx)

export WAKATIME_API_KEY="YOUR_API_KEY"
npx wakatime-mcp

🤖 MCP Config (npx)

{
  "command": "npx",
  "args": ["-y", "github:geeknees/wakatime-mcp"],
  "env": {
    "WAKATIME_API_KEY": "YOUR_API_KEY"
  }
}

🧰 Available Tools

wakatime_summaries

{
  "tool": "wakatime_summaries",
  "arguments": {
    "start": "2025-01-01",
    "end": "2025-01-07",
    "project": "my-project",
    "timezone": "Asia/Tokyo"
  }
}

wakatime_today

{
  "tool": "wakatime_today",
  "arguments": {
    "project": "my-project",
    "timezone": "Asia/Tokyo"
  }
}

⚙️ Configuration

| Environment Variable | Description | Required | | --- | --- | --- | | WAKATIME_API_KEY | WakaTime API key | ✅ |

🧪 Tests

npm test