How to Use the WakaTime (Coding Stats) MCP in Windsurf

Q: What kind of time metrics can I get with WakaTime (Coding Stats) using Windsurf?

You can check total activity since account creation via getalltimesincetoday. You also get daily totals from listsummaries, helping you see exactly how many hours you logged on a specific day.

Know exactly where you spend your time. WakaTime (Coding Stats) for Windsurf.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect WakaTime (Coding Stats) MCP to Windsurf

Create your Vinkius account to connect WakaTime (Coding Stats) to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup WakaTime (Coding Stats) with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Automate Goal Tracking with the MCP Server

Use `list_goals` to pull a list of user-defined coding goals and see their current progress. This lets Cascade figure out if you're on track for your targets, making multi-step planning easier. It also calls `get_goal` so you can check specific parameters or constraints defined by the user. If you set a goal to hit 20 hours this month, Windsurf checks that number automatically.

Analyze Time Spent per Project

The `list_projects` tool gives you every project detected in your IDE history. From there, you can use `get_stats` to pull summarized coding statistics for specific time ranges across those projects. If you need to know which part of the codebase ate up all your effort, running `list_commits` shows exactly what was changed and how much time went into each commit.

Track Time Across Tools

When you use `create_external_duration`, Windsurf can pull activity data from outside sources, like Google Calendar. This is key because it lets your agent see the whole picture of your day. It also uses `list_external_durations` to gather these external time blocks alongside your actual coding sessions. That way, you don't just track IDE time; you map out your full workflow.

Setup guide

Set up WakaTime (Coding Stats) MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the WakaTime (Coding Stats) MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my WakaTime (Coding Stats) payment history." If connected, Cascade will call the WakaTime (Coding Stats) tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "wakatime-coding-stats-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by WakaTime. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect WakaTime (Coding Stats) now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about WakaTime (Coding Stats) MCP in Windsurf

Windsurf uses the MCP Server to connect directly. It doesn't just pull data; it reads context and plans actions, so you don't have to prompt for every little step. You tell it what goal you want to hit, and it figures out how.

You can check total activity since account creation via `get_all_time_since_today`. You also get daily totals from `list_summaries`, helping you see exactly how many hours you logged on a specific day.

Yes. If your activity data is messy, the MCP Server lets you use `list_custom_rules` to see what modifications are active. You can also call `update_custom_rules` if you need to change how certain patterns of activity get logged.

The MCP Server handles authentication through a single endpoint token. This ensures that the connection is authorized and keeps your coding stats data private while Windsurf runs its autonomous tasks.

This MCP Server touches raw coding activity pings, project names, goals, and time spent in the IDE. This is all critical metrics about your professional productivity.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript