MCP server

WakaTime MCP by usefulapi

io.usefulapi/wakatime

Checked 26 Oct 2026, 08:29 UTC · Connected to it and listed its tools

Read your WakaTime coding time: summaries, stats, projects, goals, commits and leaderboards.

Website Source

At a glance

Type

MCP server

Publisher

usefulapi.io (verified by the MCP Registry)

Status

Working at last check

Tools

23

Token cost

About 5,202 tokens per request

Sets up in

Claude Code, Claude Desktop, Codex, Gemini CLI, Cursor, VS Code, Antigravity, ChatGPT, OpenAI API, Grok

Last checked

26 Oct 2026, 08:29 UTC

Connect it to your agent

Add to CursorAdd to VS CodeVS Code Insiders

Opens the app, which shows the server and asks you to confirm. For other apps, copy the setup below.

Claude Code

claude mcp add --transport http wakatime https://wakatime.usefulapi.io/mcp

Claude Desktop

Settings → Connectors → Add custom connector, and paste the URL.

Codex (config.toml)

[mcp_servers.wakatime]
url = "https://wakatime.usefulapi.io/mcp"

Gemini CLI

{"mcpServers":{"wakatime":{"httpUrl":"https://wakatime.usefulapi.io/mcp"}}}

Cursor

{"mcpServers":{"wakatime":{"url":"https://wakatime.usefulapi.io/mcp"}}}

VS Code

{"servers":{"wakatime":{"type":"http","url":"https://wakatime.usefulapi.io/mcp"}}}

Antigravity

agy mcp add wakatime https://wakatime.usefulapi.io/mcp

ChatGPT

Settings → Apps & Connectors → Advanced settings: turn on Developer mode, then Create a connector and paste the URL. Which plans can do this varies.

OpenAI API (Responses tools)

{"type":"mcp","server_label":"wakatime","server_url":"https://wakatime.usefulapi.io/mcp","require_approval":"always"}

Grok (xAI API tools)

{"type":"mcp","server_label":"wakatime","server_url":"https://wakatime.usefulapi.io/mcp"}

Tools

• wakatime_get_all_time_since_today ~124 tokens
  Total coding time since the user's WakaTime account (or one project) was created, with daily average and the range covered. GET /users/current/all_time_since_today.
• wakatime_get_commit ~214 tokens
  One commit of a WakaTime project by hash, with the time spent coding on it. Needs the read_heartbeats scope for OAuth tokens. GET /users/current/projects/{project}/commits/{hash}.
• wakatime_get_durations ~391 tokens
  The coding sessions (durations) of one day, each with start time, length in seconds and the project (or other slice) it belongs to. Needs the read_heartbeats scope for OAuth tokens. GET /users/current/durations.
• wakatime_get_goal ~122 tokens
  One goal by id with its chart data (cached; an empty chart means the cache is still building, retry shortly). GET /users/current/goals/{goal}.
• wakatime_get_heartbeats ~274 tokens
  The raw heartbeats (activity pings from editor plugins) of one day: entity (file path or domain), type, category, project, branch, language, time, lines and AI line changes. Large days are cut to `limit` heartbeats starting at `offset`; total_heartbeats says how many the day has. Needs the read_hear
• wakatime_get_insight ~416 tokens
  One WakaTime insight for a range: stats, weekdays (average per weekday), days (per-day totals, optionally one weekday), ai_days, best_day, daily_average, or a breakdown by projects, languages, editors, categories, machines or operating_systems. GET /users/current/insights/{insight_type}/{range}.
• wakatime_get_org_dashboard_summaries ~260 tokens
  One day of coding activity for every developer on an organization dashboard (grand total plus breakdowns per member). GET /users/current/orgs/{org}/dashboards/{dashboard}/summaries.
• wakatime_get_org_member_summaries ~406 tokens
  One dashboard member's coding activity as daily summaries for a date range (give start and end, or a named range). GET /users/current/orgs/{org}/dashboards/{dashboard}/members/{member}/summaries.
• wakatime_get_private_leaderboard ~308 tokens
  The ranking of a private leaderboard: rank, member and total coding time (or AI lines / AI spend) per language, country and board type; paged (without page it starts at the user's own page). GET /users/current/leaderboards/{board}.
• wakatime_get_public_leaders ~298 tokens
  WakaTime's public leaderboard of the most active coders over the last 7 days, filterable by language, country, hireable badge and ranking type; paged. Each leader is reduced to rank, name, username, country, total and daily-average time and top 3 languages. GET /leaders.
• wakatime_get_stats ~289 tokens
  Aggregated coding stats for a range: total time, daily average, best day, AI vs human line changes, and the full breakdown by language, project, editor, operating system, category, dependencies and machine. If the reply says it is still calculating, call again shortly. GET /users/current/stats/{rang
• wakatime_get_status_bar_today ~114 tokens
  Today's coding activity as shown in an editor status bar: grand total plus breakdowns by project, language, editor and more. Cached data only; an empty summary means the cache is still being filled. GET /users/current/status_bar/today.
• wakatime_get_summaries ~472 tokens
  Coding activity as one summary per day for a date range: grand total plus breakdowns by project, language, editor, operating system, category, dependencies and machine, with cumulative total and daily average. Give start and end, or one named range. Use project (and branches) to also get per-branch
• wakatime_get_user ~90 tokens
  The WakaTime user this key belongs to: id, username, display name, email, timezone, plan, last plugin/project/branch and last heartbeat time. GET /users/current.
• wakatime_list_commits ~268 tokens
  Commits of a WakaTime project with the time spent coding on each (needs a connected repository). Filter by author or branch; paged. Needs the read_heartbeats scope for OAuth tokens. GET /users/current/projects/{project}/commits.
• wakatime_list_goals ~146 tokens
  The user's coding goals: title, type, target seconds, status, chart data per period, languages/projects/editors it covers and who it is shared with. Needs the read_goals scope for OAuth tokens. GET /users/current/goals.
• wakatime_list_machines ~85 tokens
  The machines (computers) that sent coding activity: id, name, host name, IP, timezone and last-seen time. GET /users/current/machine_names.
• wakatime_list_org_dashboard_members ~215 tokens
  The members of an organization dashboard: id, username, full name, email, photo and whether their activity is view-only hidden. GET /users/current/orgs/{org}/dashboards/{dashboard}/members.
• wakatime_list_org_dashboards ~167 tokens
  The dashboards of an organization: id, name, timezone, member count and what the user may view or join. GET /users/current/orgs/{org}/dashboards.
• wakatime_list_orgs ~143 tokens
  The WakaTime organizations the user belongs to: id, name, people count, keystroke timeout and timezone preferences and what the user may do. Needs the read_orgs scope for OAuth tokens. GET /users/current/orgs.
• wakatime_list_private_leaderboards ~140 tokens
  The private leaderboards the user is in: id, name, time range, member count and edit rights. Needs the read_private_leaderboards scope for OAuth tokens. GET /users/current/leaderboards.
• wakatime_list_projects ~171 tokens
  The user's WakaTime projects with id, name, repository, color, clients, first and last heartbeat time and badge/public-url flags. Optionally filter by a name search. GET /users/current/projects.
• wakatime_list_user_agents ~89 tokens
  The editor and plugin user agents that sent coding activity: editor, version, OS, AI model if any, and last-seen time. GET /users/current/user_agents.

Browse

• Email

Related MCP servers

• Wakatime
  WakaTime MCP.
• Framezone
  Your life dashboard for AI: tasks, habits, goals, budgets, workouts, nutrition, journal, notes.
• Airbrake MCP by usefulapi
  Read Airbrake projects, error groups, notices, deploys and stats; mute or unmute error groups.
• Tick MCP by usefulapi
  Read Tick clients, projects, tasks, users and time entries; log and edit time entries.
• Weblate MCP by usefulapi
  Read Weblate projects, strings, stats and changes; translate, suggest, comment and autotranslate.
• kiwiHR MCP by usefulapi
  Read kiwiHR employees, time off, timesheets, projects; create and update employees, timesheets.
• Forge Engine
  Design spec + milestones AI coding agents read before building; drift flagged, changes reviewed.
• Clockify MCP by usefulapi
  Track time in Clockify: time entries, projects, clients, tags and reports; start, stop and log time.

Badge for your README

[![AptLynx](https://aptlynx.net/badge/io.usefulapi/wakatime.svg)](https://aptlynx.net/servers/io.usefulapi/wakatime)

Listing text is written by the maker; AptLynx lists tools and does not vouch for them. Find another tool · Browse by topic · For agents