Download PDFMarkdown Version
ClaudeChatGPTPerplexityGeminiMicrosoft CopilotRaycastMeta AIGrokZ.aiQwenKimi
DeepSeekMistralCursorVS CodeWindsurfJetBrainsClineLovableVercel AI SDKLangChain

Use WakaTime with your AI.

Connect your account once and let the AI you already use work with it, without building another integration. Track your coding activity and productivity metrics directly through WakaTime. monitor projects, goals, and time spent in your IDE.

Included with plan

Ask AI about this Connector

Developed, maintained, and hosted by Vinkius.

MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED

Waiting for input…

Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.

ChatGPTClaudeCursorPerplexityGeminiMicrosoft CopilotRaycastMeta AI

Complete set · 14 capabilities

The complete WakaTime capability set.

These are the exact actions your AI can choose when you ask it to work with WakaTime.

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 14 available through WakaTime.

  1. 01

    Get all time since today

    Get total time logged since account creation

  2. 02

    List custom rules

    Get rules to modify or delete coding activity based on patterns

  3. 03

    List external durations

    G., Google Calendar). Get activity created from external apps

  4. 04

    List goals

    List user-defined coding goals and their progress

Capability set02 / 04

05-08

4 capabilities in this set.

Part of 14 available through WakaTime.

  1. 05

    List heartbeats

    Get raw coding activity pings from IDE plugins

  2. 06

    List projects

    List of projects detected for the user

  3. 07

    Create external duration

    Create activity from an external app

  4. 08

    Create heartbeat

    Create a raw coding activity ping

Capability set03 / 04

09-11

3 capabilities in this set.

Part of 14 available through WakaTime.

  1. 09

    Get goal

    Get a specific user-defined coding goal

  2. 10

    Get stats

    Get summarized coding statistics for a given range

  3. 11

    List commits

    List of commits for a project with time spent on each

Capability set04 / 04

12-14

3 capabilities in this set.

Part of 14 available through WakaTime.

  1. 12

    List durations

    Get coding activity joined into blocks based on keystroke timeout

  2. 13

    List summaries

    Get daily totals of coding activity

  3. 14

    Update custom rules

    Update rules to modify or delete coding activity

Observed, not estimated

928ms average. Fast in production.

WakaTime is checked daily against the live service.

Daily averagePeak 1160ms
Aug 20Today
Fastest day
766ms
Slowest day
1160ms
14-day trend
Slowing+13%

Connect your client

One URL. Every client.

Activate the Connector, copy your link, and paste it into the client you already use. 14 capabilities arrive ready to run.

Preview access · not provider authentication

The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of WakaTime, so you can see the experience inside your AI.

It does not authenticate your account with WakaTime. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.

WakaTime Connector

You're all set. Choose your MCP client and follow the setup instructions.

Connector linkhttps://edge.vinkius.com/vk_preview_AB4t6k4hg7aaksv2YUC1kPAcw00en9TrAEER6qs2/mcp

Claude Desktop

Follow the steps below to connect in seconds.

  1. 1In Claude Desktop, open Settings → Connectors.
  2. 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
  3. 3Click Add and start a new chat — WakaTime capabilities are ready to use.
Configuration · claude_desktop_config.jsonCopy
{
  "mcpServers": {
    "wakatime-coding-stats-mcp": {
      "url": "https://edge.vinkius.com/vk_preview_AB4t6k4hg7aaksv2YUC1kPAcw00en9TrAEER6qs2/mcp"
    }
  }
}
  • Claude
  • ChatGPT
  • Cursor
  • VS Code
  • Windsurf
  • Claude Code
  • JetBrains
  • Cline

Step-by-step instructions for each client are in the guide. How to connect

FAQ

Questions WakaTime owners ask.

  • 01

    Can I get a summary of my coding activity for the last week?

    Yes! Use the get_stats capability with the range 'last_7_days'. Your agent will return aggregated data including total time, languages used, and project breakdown.

  • 02

    How do I check my progress on my coding goals?

    Run the list_goals capability to see all your active goals and their current completion percentage. You can also use get_goal with a specific ID for deeper details.

  • 03

    Can I see which projects I've been working on?

    Yes, the list_projects capability will return a list of all projects detected by your WakaTime plugins. You can then use list_summaries to see time spent on them.

Explore

More in Productivity

Suggestions