📦

Wakatime MCP

An MCP server that exposes WakaTime summary tools over stdio.

0 installs

Trust: 34 — Low

Commerce

Ask AI about Wakatime MCP

Powered by Claude · Grounded in docs

I know everything about Wakatime MCP. Ask me about installation, configuration, usage, or troubleshooting.

0/500

Documentation

🚀 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