How do I connect my WakaTime data to Claude?

You subscribe to the MCP on Vinkius and enter your WakaTime API Key. Once connected, you can query your data directly within the Claude interface.

Which IDEs work with this MCP?

This MCP works with any compatible client, including Cursor, Windsurf, and VS Code.

Can I track specific projects?

Yes, the MCP can list all projects detected by your IDE plugins and provide activity summaries for them.

Does this work with my existing WakaTime goals?

Yes, your agent can list your user-defined goals and check your current progress against them.

Is my API key stored securely?

Vinkius manages your credentials and hosts the MCP, ensuring your connection remains secure and active.

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.

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.

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.

An astronaut overseeing a futuristic data hub

Download PDF Markdown Version

Connect Wakatime Coding Stats to ChatGPT, Claude and Gemini

Set it up once and it works in ChatGPT, Claude, Cursor, and any other client you love. It all runs safely in the background, so you can relax and focus on what really matters. Turn your raw coding heartbeats into actionable insights through conversation.

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.

Your AI does the work. We keep it safe and sound.

No other AI tool gives you this. Your workflow runs in the client you already love, your account stays protected, and you decide what the agent can and cannot do. It is the whole reason to make the switch.

Each Connector lives inside our infrastructure, the same place where your workflow runs. The three things below are already part of it, working quietly in the background so you never have to think about them. Nothing to add, nothing to set up, nothing to worry about.

V8 Isolate01

Each Connector runs inside its own sealed environment.

Each Connector runs inside its own sealed V8 runtime — no access to your files, your system, or other servers. A Connector never sees past its own request.

Kill Switch02

One switch stops every agent. Instantly.

One action deactivates every Connector, revokes every token, and ends every session at once. AI Governance keeps the record.

FinOps per User03

Spending limits that pause instead of surprise.

Every user keeps their own connections and credentials, isolated from everyone else. Anything that would cross your spending limit is held for your approval, not billed.

Three controls, built into the layer your AI connects through.

Curated set · 14 capabilities

We ship only the actions that matter.

Capability set01 / 04

01-04

4 capabilities in this set.

Part of 14 available through WakaTime.

01
Get all time since today
Retrieves the total amount of time you have logged since your account was created.
02
List custom rules
Fetches the rules you have set to modify or delete specific coding activity patterns.
03
List external durations
Gets activity data that was generated by external applications.
04
List goals
Returns a list of your user-defined coding goals and their current progress.

Capability set02 / 04

05-08

4 capabilities in this set.

Part of 14 available through WakaTime.

05
List heartbeats
Accesses the raw coding activity pings sent from your IDE plugins.
06
List projects
Provides a list of all projects detected by your WakaTime setup.
07
Create external duration
Allows your agent to create new activity entries from an external application.
08
Create heartbeat
Lets your agent manually create a raw coding activity ping.

Capability set03 / 04

09-11

3 capabilities in this set.

Part of 14 available through WakaTime.

09
Get goal
Fetches the specific details for a single user-defined coding goal.
10
Get stats
Retrieves summarized coding statistics for a specific time range you define.
11
List commits
Lists the commits for a specific project along with the time spent on each.

Capability set04 / 04

12-14

3 capabilities in this set.

Part of 14 available through WakaTime.

12
List durations
Gets coding activity that has been grouped into blocks based on your keystroke timeouts.
13
List summaries
Provides daily totals of your coding activity.
14
Update custom rules
Modifies existing rules used to adjust or remove coding activity.

Real work

What teams actually run

Weekly Review

Ask your agent to summarize your total coding time and top languages every Friday afternoon.

Project Costing

Determine exactly how many hours were spent on a specific repository to estimate project effort.

Goal Check-ins

Query your agent to see if you are on track to meet your daily or weekly coding hour targets.

Workflow Optimization

Analyze duration blocks to find when you are most active and when your coding sessions tend to break.

Automate a task

Put WakaTime to work on one thing.

Step-by-step automations your AI runs through this Connector: the workflow, the prompts to start with, and the exact capabilities behind each move.

One connector, every AI

WakaTime works with the most popular AI clients.

These are the most popular clients, each with a step-by-step guide: one link, set up once, with governance and visibility built in. And because everything runs on the MCP standard, the same connection also works in any other compatible client — nothing to rebuild.

Building your own app? The connector is yours to use.

You don't need a client to put WakaTime to work: the same hosted connection plugs into your own applications and agent code, with the same governance on every request. Build with it, chat with it — one connection for both.

Observed, not estimated

1070ms average. Fast in production.

WakaTime is checked daily against the live service.

Daily averagePeak 1299ms

Oct 3Today

Fastest day: 832ms
Slowest day: 1299ms
14-day trend: Stable0%

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.

1In Claude Desktop, open Settings → Connectors.
2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
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

Guided setup for Claude? Set up WakaTime in Claude and other AIs

See all the AI clients this connector works with ↑

Who it's for

Built for the work WakaTime owners hand off.

This MCP is built for developers who want to use their AI agent to audit their own work habits and productivity.

01
Developers
They use the agent to track personal productivity and project time allocation.
02
Team Leads
They check high-level project activity and goal progress without asking for manual reports.
03
Data Enthusiasts
They analyze raw heartbeats and patterns to optimize their daily coding workflows.

FAQ

Questions WakaTime owners ask.

01
How do I connect my WakaTime data to Claude?
You subscribe to the MCP on Vinkius and enter your WakaTime API Key. Once connected, you can query your data directly within the Claude interface.
02
Which IDEs work with this MCP?
This MCP works with any compatible client, including Cursor, Windsurf, and VS Code.
03
Can I track specific projects?
Yes, the MCP can list all projects detected by your IDE plugins and provide activity summaries for them.
04
Does this work with my existing WakaTime goals?
Yes, your agent can list your user-defined goals and check your current progress against them.
05
Is my API key stored securely?
Vinkius manages your credentials and hosts the MCP, ensuring your connection remains secure and active.
06
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.
07
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.
08
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

Connect WakaTime to Claude, Cursor, ChatGPT & more

Your AI does the work. We keep it safe and sound.

Each Connector runs inside its own sealed environment.

One switch stops every agent. Instantly.

Spending limits that pause instead of surprise.

We ship only the actions that matter.

01-04

Get all time since today

List custom rules

List external durations

List goals

05-08

List heartbeats

List projects

Create external duration

Create heartbeat

09-11

Get goal

Get stats

List commits

12-14

List durations

List summaries

Update custom rules

What teams actually run

Weekly Review

Project Costing

Goal Check-ins

Workflow Optimization

Building your own app? The connector is yours to use.

WakaTime Connector

Claude Desktop

Developers

Team Leads

Data Enthusiasts

How do I connect my WakaTime data to Claude?

Which IDEs work with this MCP?

Can I track specific projects?

Does this work with my existing WakaTime goals?

Is my API key stored securely?

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

How do I check my progress on my coding goals?

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

Wakapi (WakaTime Alternative) AI Connector

GitScrum Time Tracking AI Connector

Everhour Time Tracking AI Connector

Coder Legion Developers AI Connector

Suggestions

Innovation Time-to-Market Engine AI Connector

Timeero AI Connector

TrackingTime AI Connector

Time-Series Seasonality Engine AI Connector