Skip to main content
Glama

WakaTime MCP by usefulapi

Server Details

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

If you are the author of this connector, you can claim ownership by verifying the domain or GitHub account it belongs to. Claimed connector authors can inspect health checks, view analytics, and manage their listing.
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 tools
wakatime_get_all_time_since_todayGet all-time total
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
projectNoOnly this project's total.
wakatime_get_commitGet project commit
Read-only
Inspect

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}.

ParametersJSON Schema
NameRequiredDescriptionDefault
hashYesCommit hash (from wakatime_list_commits).
branchNoBranch (default: the repository's default branch).
projectYesProject name exactly as WakaTime shows it (see wakatime_list_projects).
wakatime_get_durationsGet durations for a day
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateYesThe day, yyyy-mm-dd, in the user's timezone.
projectNoOnly durations for this project.
timeoutNoKeystroke timeout in minutes (default: the user's preference).
branchesNoComma separated branch names; needs project.
slice_byNoWhat to slice durations by (default project).
timezoneNoIANA timezone such as Europe/Berlin (default: the user's timezone).
writes_onlyNoOnly count heartbeats that were file writes (default: the user's preference).
wakatime_get_goalGet goal
Read-only
Inspect

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}.

ParametersJSON Schema
NameRequiredDescriptionDefault
goal_idYesGoal id (from wakatime_list_goals).
wakatime_get_heartbeatsGet heartbeats for a day
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateYesThe day, yyyy-mm-dd, 12am to 11:59pm in the user's timezone.
limitNoReturn at most this many heartbeats (default 200).
offsetNoSkip this many heartbeats first (to read a busy day in slices; default 0).
wakatime_get_insightGet insight
Read-only
Inspect

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}.

ParametersJSON Schema
NameRequiredDescriptionDefault
rangeNoTime range: last_7_days, last_30_days, last_6_months, last_year, all_time, a year (2026) or a month (2026-09).last_year
timeoutNoKeystroke timeout in minutes (default: the user's preference).
weekdayNoOnly for insight_type 'days': a weekday, 0-6 or monday..sunday.
writes_onlyNoOnly count heartbeats that were file writes (default: the user's preference).
insight_typeYes
wakatime_get_org_dashboard_summariesGet dashboard summaries for a day
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateYesThe day, yyyy-mm-dd.
org_idYesOrganization id.
projectNoOnly time logged to this project.
branchesNoComma separated branch names; needs project.
dashboard_idYesDashboard id.
wakatime_get_org_member_summariesGet dashboard member summaries
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
endNoLast day, yyyy-mm-dd, inclusive (with start).
rangeNoAlternative to start and end.
startNoFirst day, yyyy-mm-dd (with end).
org_idYesOrganization id.
projectNoOnly time logged to this project.
branchesNoComma separated branch names; needs project.
member_idYesMember id (from wakatime_list_org_dashboard_members).
dashboard_idYesDashboard id.
wakatime_get_private_leaderboardGet private leaderboard
Read-only
Inspect

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}.

ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number, from 1. Pass the previous reply's next_page.
board_idYesLeaderboard id (from wakatime_list_private_leaderboards).
languageNoOnly this language.
board_typeNoRanking: time (hours coded, default), manual (excluding AI coding), ai (AI lines) or spend (AI spend).
country_codeNoTwo-letter country code.
wakatime_get_public_leadersGet public leaderboard
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number, from 1. Pass the previous reply's next_page.
languageNoOnly this language.
board_typeNoRanking: time (hours coded, default), manual (excluding AI coding), ai (AI lines) or spend (AI spend).
is_hireableNoOnly coders with the hireable badge.
country_codeNoTwo-letter country code.
wakatime_get_statsGet coding stats
Read-only
Inspect

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}.

ParametersJSON Schema
NameRequiredDescriptionDefault
rangeNoTime 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
timeoutNoKeystroke timeout in minutes (default: the user's preference).
writes_onlyNoOnly count heartbeats that were file writes (default: the user's preference).
wakatime_get_status_bar_todayGet today's coding time
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

wakatime_get_summariesGet daily summaries
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
endNoLast day, yyyy-mm-dd, inclusive (with start).
rangeNoAlternative to start and end.
startNoFirst day, yyyy-mm-dd (with end).
projectNoOnly time logged to this project.
timeoutNoKeystroke timeout in minutes (default: the user's preference).
branchesNoComma separated branch names; needs project.
timezoneNoIANA timezone such as Europe/Berlin (default: the user's timezone).
writes_onlyNoOnly count heartbeats that were file writes (default: the user's preference).
wakatime_get_userGet current user
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

wakatime_list_commitsList project commits
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number, from 1. Pass the previous reply's next_page.
authorNoOnly commits by this author (WakaTime username).
branchNoBranch (default: the repository's default branch).
projectYesProject name exactly as WakaTime shows it (see wakatime_list_projects).
wakatime_list_goalsList goals
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number, from 1. Pass the previous reply's next_page.
wakatime_list_machinesList machines
Read-only
Inspect

The machines (computers) that sent coding activity: id, name, host name, IP, timezone and last-seen time. GET /users/current/machine_names.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

wakatime_list_org_dashboard_membersList dashboard members
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number, from 1. Pass the previous reply's next_page.
org_idYesOrganization id.
dashboard_idYesDashboard id (from wakatime_list_org_dashboards).
wakatime_list_org_dashboardsList organization dashboards
Read-only
Inspect

The dashboards of an organization: id, name, timezone, member count and what the user may view or join. GET /users/current/orgs/{org}/dashboards.

ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number, from 1. Pass the previous reply's next_page.
org_idYesOrganization id (from wakatime_list_orgs).
wakatime_list_orgsList organizations
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number, from 1. Pass the previous reply's next_page.
wakatime_list_private_leaderboardsList private leaderboards
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
pageNoPage number, from 1. Pass the previous reply's next_page.
wakatime_list_projectsList projects
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
qNoFilter project names by this search term.
pageNoPage number, from 1. Pass the previous reply's next_page.
wakatime_list_user_agentsList editors and plugins used
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 23 tool updates
    • First observedwakatime_get_all_time_since_today
    • First observedwakatime_get_commit
    • First observedwakatime_get_durations
    • First observedwakatime_get_goal
    • First observedwakatime_get_heartbeats
    • First observedwakatime_get_insight
    • First observedwakatime_get_org_dashboard_summaries
    • First observedwakatime_get_org_member_summaries
    • First observedwakatime_get_private_leaderboard
    • First observedwakatime_get_public_leaders
    • First observedwakatime_get_stats
    • First observedwakatime_get_status_bar_today
    • First observedwakatime_get_summaries
    • First observedwakatime_get_user
    • First observedwakatime_list_commits
    • First observedwakatime_list_goals
    • First observedwakatime_list_machines
    • First observedwakatime_list_org_dashboard_members
    • First observedwakatime_list_org_dashboards
    • First observedwakatime_list_orgs
    • First observedwakatime_list_private_leaderboards
    • First observedwakatime_list_projects
    • First observedwakatime_list_user_agents

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides 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
  • A
    license
    A
    quality
    C
    maintenance
    Exposes WakaTime Summaries API tools over stdio, enabling daily and today's coding activity summaries via MCP.
    10
    15 npm
    MIT
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.