WakaTime MCP by usefulapi
Server Details
Read your WakaTime coding time: summaries, stats, projects, goals, commits and leaderboards.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-06-18
- URL
- Repository
- m190/usefulapi-mcp
- GitHub Stars
- 0
TDQS
Score is being calculated.
Available Tools
23 toolswakatime_get_all_time_since_todayGet all-time totalRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| project | No | Only this project's total. |
wakatime_get_commitGet project commitRead-onlyInspect
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}.
| Name | Required | Description | Default |
|---|---|---|---|
| hash | Yes | Commit hash (from wakatime_list_commits). | |
| branch | No | Branch (default: the repository's default branch). | |
| project | Yes | Project name exactly as WakaTime shows it (see wakatime_list_projects). |
wakatime_get_durationsGet durations for a dayRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | The day, yyyy-mm-dd, in the user's timezone. | |
| project | No | Only durations for this project. | |
| timeout | No | Keystroke timeout in minutes (default: the user's preference). | |
| branches | No | Comma separated branch names; needs project. | |
| slice_by | No | What to slice durations by (default project). | |
| timezone | No | IANA timezone such as Europe/Berlin (default: the user's timezone). | |
| writes_only | No | Only count heartbeats that were file writes (default: the user's preference). |
wakatime_get_goalGet goalRead-onlyInspect
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}.
| Name | Required | Description | Default |
|---|---|---|---|
| goal_id | Yes | Goal id (from wakatime_list_goals). |
wakatime_get_heartbeatsGet heartbeats for a dayRead-onlyInspect
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_heartbeats scope for OAuth tokens. GET /users/current/heartbeats.
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | The day, yyyy-mm-dd, 12am to 11:59pm in the user's timezone. | |
| limit | No | Return at most this many heartbeats (default 200). | |
| offset | No | Skip this many heartbeats first (to read a busy day in slices; default 0). |
wakatime_get_insightGet insightRead-onlyInspect
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}.
| Name | Required | Description | Default |
|---|---|---|---|
| range | No | Time range: last_7_days, last_30_days, last_6_months, last_year, all_time, a year (2026) or a month (2026-09). | last_year |
| timeout | No | Keystroke timeout in minutes (default: the user's preference). | |
| weekday | No | Only for insight_type 'days': a weekday, 0-6 or monday..sunday. | |
| writes_only | No | Only count heartbeats that were file writes (default: the user's preference). | |
| insight_type | Yes |
wakatime_get_org_dashboard_summariesGet dashboard summaries for a dayRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| date | Yes | The day, yyyy-mm-dd. | |
| org_id | Yes | Organization id. | |
| project | No | Only time logged to this project. | |
| branches | No | Comma separated branch names; needs project. | |
| dashboard_id | Yes | Dashboard id. |
wakatime_get_org_member_summariesGet dashboard member summariesRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Last day, yyyy-mm-dd, inclusive (with start). | |
| range | No | Alternative to start and end. | |
| start | No | First day, yyyy-mm-dd (with end). | |
| org_id | Yes | Organization id. | |
| project | No | Only time logged to this project. | |
| branches | No | Comma separated branch names; needs project. | |
| member_id | Yes | Member id (from wakatime_list_org_dashboard_members). | |
| dashboard_id | Yes | Dashboard id. |
wakatime_get_private_leaderboardGet private leaderboardRead-onlyInspect
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}.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1. Pass the previous reply's next_page. | |
| board_id | Yes | Leaderboard id (from wakatime_list_private_leaderboards). | |
| language | No | Only this language. | |
| board_type | No | Ranking: time (hours coded, default), manual (excluding AI coding), ai (AI lines) or spend (AI spend). | |
| country_code | No | Two-letter country code. |
wakatime_get_public_leadersGet public leaderboardRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1. Pass the previous reply's next_page. | |
| language | No | Only this language. | |
| board_type | No | Ranking: time (hours coded, default), manual (excluding AI coding), ai (AI lines) or spend (AI spend). | |
| is_hireable | No | Only coders with the hireable badge. | |
| country_code | No | Two-letter country code. |
wakatime_get_statsGet coding statsRead-onlyInspect
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/{range}.
| Name | Required | Description | Default |
|---|---|---|---|
| range | No | Time range: last_7_days, last_30_days, last_6_months, last_year, all_time, a year (2026) or a month (2026-09). | last_7_days |
| timeout | No | Keystroke timeout in minutes (default: the user's preference). | |
| writes_only | No | Only count heartbeats that were file writes (default: the user's preference). |
wakatime_get_status_bar_todayGet today's coding timeRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
wakatime_get_summariesGet daily summariesRead-onlyInspect
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 and per-file entities. GET /users/current/summaries.
| Name | Required | Description | Default |
|---|---|---|---|
| end | No | Last day, yyyy-mm-dd, inclusive (with start). | |
| range | No | Alternative to start and end. | |
| start | No | First day, yyyy-mm-dd (with end). | |
| project | No | Only time logged to this project. | |
| timeout | No | Keystroke timeout in minutes (default: the user's preference). | |
| branches | No | Comma separated branch names; needs project. | |
| timezone | No | IANA timezone such as Europe/Berlin (default: the user's timezone). | |
| writes_only | No | Only count heartbeats that were file writes (default: the user's preference). |
wakatime_get_userGet current userRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
wakatime_list_commitsList project commitsRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1. Pass the previous reply's next_page. | |
| author | No | Only commits by this author (WakaTime username). | |
| branch | No | Branch (default: the repository's default branch). | |
| project | Yes | Project name exactly as WakaTime shows it (see wakatime_list_projects). |
wakatime_list_goalsList goalsRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1. Pass the previous reply's next_page. |
wakatime_list_machinesList machinesRead-onlyInspect
The machines (computers) that sent coding activity: id, name, host name, IP, timezone and last-seen time. GET /users/current/machine_names.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
wakatime_list_org_dashboard_membersList dashboard membersRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1. Pass the previous reply's next_page. | |
| org_id | Yes | Organization id. | |
| dashboard_id | Yes | Dashboard id (from wakatime_list_org_dashboards). |
wakatime_list_org_dashboardsList organization dashboardsRead-onlyInspect
The dashboards of an organization: id, name, timezone, member count and what the user may view or join. GET /users/current/orgs/{org}/dashboards.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1. Pass the previous reply's next_page. | |
| org_id | Yes | Organization id (from wakatime_list_orgs). |
wakatime_list_orgsList organizationsRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1. Pass the previous reply's next_page. |
wakatime_list_private_leaderboardsList private leaderboardsRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| page | No | Page number, from 1. Pass the previous reply's next_page. |
wakatime_list_projectsList projectsRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Filter project names by this search term. | |
| page | No | Page number, from 1. Pass the previous reply's next_page. |
wakatime_list_user_agentsList editors and plugins usedRead-onlyInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
23 tool updates
- First observed
wakatime_get_all_time_since_today - First observed
wakatime_get_commit - First observed
wakatime_get_durations - First observed
wakatime_get_goal - First observed
wakatime_get_heartbeats - First observed
wakatime_get_insight - First observed
wakatime_get_org_dashboard_summaries - First observed
wakatime_get_org_member_summaries - First observed
wakatime_get_private_leaderboard - First observed
wakatime_get_public_leaders - First observed
wakatime_get_stats - First observed
wakatime_get_status_bar_today - First observed
wakatime_get_summaries - First observed
wakatime_get_user - First observed
wakatime_list_commits - First observed
wakatime_list_goals - First observed
wakatime_list_machines - First observed
wakatime_list_org_dashboard_members - First observed
wakatime_list_org_dashboards - First observed
wakatime_list_orgs - First observed
wakatime_list_private_leaderboards - First observed
wakatime_list_projects - First observed
wakatime_list_user_agents
Related MCP Connectors
Read WHOOP recovery, sleep, cycles, workouts and body measurements.
Read Simple Analytics stats: pageviews, visitors, pages, referrers, events and data exports.
61- PithflowOAuthcom.pithflow
Read-only access to your own Pithflow meeting notes, transcripts, dictionary and usage.
Read time entries, projects, clients, tasks and invoices; log and update tracked time.
Related MCP Servers
- AlicenseBqualityAmaintenanceEnables tracking and analyzing development time through the Wakapi API. Provides tools to retrieve coding statistics, project details, leaderboards, and recent activity logs for productivity insights.81Apache 2.0
- AlicenseNot gradedqualityDmaintenanceProvides access to WakaTime coding analytics data through MCP tools. Enables querying coding stats, activity summaries, project lists, and time tracking information from your WakaTime account.MIT
- AlicenseAqualityCmaintenanceExposes WakaTime Summaries API tools over stdio, enabling daily and today's coding activity summaries via MCP.1015 npmMIT
- AlicenseNot gradedqualityBmaintenanceEnables querying WakaTime coding activity data including summaries, stats, durations, and commits through an MCP server integrated with Pipeworx gateway.53 npmMIT
Glama MCP Gateway
Add one secure layer between your agents and this server.