Servers Playground How we check Add a server Log in

WakaTime MCP by usefulapi

Working · 367 ms

io.usefulapi/wakatimev1.8.0 Domain verified

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

Developer Tools

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://wakatime.usefulapi.io/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

wakatime_get_all_time_since_today Read-only

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.

projectstring

Only this project's total.

WakaTime MCP by usefulapi MCP server | mcptry

Tools (23)

wakatime_get_all_time_since_today

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.

read-only

Argument	Type	Description
project	string	Only this project's total.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "project": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Only this project's total."
    }
  }
}

wakatime_get_commit

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

read-only

Argument	Type	Description
hash*	string	Commit hash (from wakatime_list_commits).
branch	string	Branch (default: the repository's default branch).
project*	string	Project name exactly as WakaTime shows it (see wakatime_list_projects).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project",
    "hash"
  ],
  "properties": {
    "hash": {
      "type": "string",
      "pattern": "^[0-9a-fA-F]{4,64}$",
      "description": "Commit hash (from wakatime_list_commits)."
    },
    "branch": {
      "type": "string",
      "maxLength": 250,
      "minLength": 1,
      "description": "Branch (default: the repository's default branch)."
    },
    "project": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Project name exactly as WakaTime shows it (see wakatime_list_projects)."
    }
  }
}

wakatime_get_durations

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.

read-only

Argument	Type	Description
date*	string	The day, yyyy-mm-dd, in the user's timezone.
project	string	Only durations for this project.
timeout	integer	Keystroke timeout in minutes (default: the user's preference).
branches	string	Comma separated branch names; needs project.
slice_by	string	What to slice durations by (default project).
timezone	string	IANA timezone such as Europe/Berlin (default: the user's timezone).
writes_only	boolean	Only count heartbeats that were file writes (default: the user's preference).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "The day, yyyy-mm-dd, in the user's timezone."
    },
    "project": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Only durations for this project."
    },
    "timeout": {
      "type": "integer",
      "maximum": 1440,
      "description": "Keystroke timeout in minutes (default: the user's preference).",
      "exclusiveMinimum": 0
    },
    "branches": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Comma separated branch names; needs project."
    },
    "slice_by": {
      "enum": [
        "project",
        "entity",
        "language",
        "dependencies",
        "os",
        "editor",
        "category",
        "machine"
      ],
      "type": "string",
      "description": "What to slice durations by (default project)."
    },
    "timezone": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_+\\-/]+$",
      "maxLength": 64,
      "minLength": 1,
      "description": "IANA timezone such as Europe/Berlin (default: the user's timezone)."
    },
    "writes_only": {
      "type": "boolean",
      "description": "Only count heartbeats that were file writes (default: the user's preference)."
    }
  }
}

wakatime_get_goal

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

read-only

Argument	Type	Description
goal_id*	string	Goal id (from wakatime_list_goals).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "goal_id"
  ],
  "properties": {
    "goal_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Goal id (from wakatime_list_goals)."
    }
  }
}

wakatime_get_heartbeats

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.

read-only

Argument	Type	Description
date*	string	The day, yyyy-mm-dd, 12am to 11:59pm in the user's timezone.
limit	integer	Return at most this many heartbeats (default 200).
offset	integer	Skip this many heartbeats first (to read a busy day in slices; default 0).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "The day, yyyy-mm-dd, 12am to 11:59pm in the user's timezone."
    },
    "limit": {
      "type": "integer",
      "maximum": 2000,
      "description": "Return at most this many heartbeats (default 200).",
      "exclusiveMinimum": 0
    },
    "offset": {
      "type": "integer",
      "maximum": 1000000,
      "minimum": 0,
      "description": "Skip this many heartbeats first (to read a busy day in slices; default 0)."
    }
  }
}

wakatime_get_insight

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

read-only

Argument	Type	Description
range	string	Time range: last_7_days, last_30_days, last_6_months, last_year, all_time, a year (2026) or a month (2026-09).
timeout	integer	Keystroke timeout in minutes (default: the user's preference).
weekday	any	Only for insight_type 'days': a weekday, 0-6 or monday..sunday.
writes_only	boolean	Only count heartbeats that were file writes (default: the user's preference).
insight_type*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "insight_type"
  ],
  "properties": {
    "range": {
      "type": "string",
      "default": "last_year",
      "pattern": "^(?:last_7_days|last_30_days|last_6_months|last_year|all_time|\\d{4}|\\d{4}-(?:0[1-9]|1[0-2]))$",
      "description": "Time range: last_7_days, last_30_days, last_6_months, last_year, all_time, a year (2026) or a month (2026-09)."
    },
    "timeout": {
      "type": "integer",
      "maximum": 1440,
      "description": "Keystroke timeout in minutes (default: the user's preference).",
      "exclusiveMinimum": 0
    },
    "weekday": {
      "anyOf": [
        {
          "type": "integer",
          "maximum": 6,
          "minimum": 0
        },
        {
          "enum": [
            "monday",
            "tuesday",
            "wednesday",
            "thursday",
            "friday",
            "saturday",
            "sunday"
          ],
          "type": "string"
        }
      ],
      "description": "Only for insight_type 'days': a weekday, 0-6 or monday..sunday."
    },
    "writes_only": {
      "type": "boolean",
      "description": "Only count heartbeats that were file writes (default: the user's preference)."
    },
    "insight_type": {
      "enum": [
        "stats",
        "weekdays",
        "days",
        "ai_days",
        "best_day",
        "daily_average",
        "projects",
        "languages",
        "editors",
        "categories",
        "machines",
        "operating_systems"
      ],
      "type": "string"
    }
  }
}

wakatime_get_org_dashboard_summaries

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.

read-only

Argument	Type	Description
date*	string	The day, yyyy-mm-dd.
org_id*	string	Organization id.
project	string	Only time logged to this project.
branches	string	Comma separated branch names; needs project.
dashboard_id*	string	Dashboard id.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "org_id",
    "dashboard_id",
    "date"
  ],
  "properties": {
    "date": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "The day, yyyy-mm-dd."
    },
    "org_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Organization id."
    },
    "project": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Only time logged to this project."
    },
    "branches": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Comma separated branch names; needs project."
    },
    "dashboard_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Dashboard id."
    }
  }
}

wakatime_get_org_member_summaries

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.

read-only

Argument	Type	Description
end	string	Last day, yyyy-mm-dd, inclusive (with start).
range	string	Alternative to start and end.
start	string	First day, yyyy-mm-dd (with end).
org_id*	string	Organization id.
project	string	Only time logged to this project.
branches	string	Comma separated branch names; needs project.
member_id*	string	Member id (from wakatime_list_org_dashboard_members).
dashboard_id*	string	Dashboard id.

Input schema (JSON)

wakatime_get_private_leaderboard

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

read-only

Argument	Type	Description
page	integer	Page number, from 1. Pass the previous reply's next_page.
board_id*	string	Leaderboard id (from wakatime_list_private_leaderboards).
language	string	Only this language.
board_type	string	Ranking: time (hours coded, default), manual (excluding AI coding), ai (AI lines) or spend (AI spend).
country_code	string	Two-letter country code.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "board_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1. Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "board_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Leaderboard id (from wakatime_list_private_leaderboards)."
    },
    "language": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Only this language."
    },
    "board_type": {
      "enum": [
        "time",
        "manual",
        "ai",
        "spend"
      ],
      "type": "string",
      "description": "Ranking: time (hours coded, default), manual (excluding AI coding), ai (AI lines) or spend (AI spend)."
    },
    "country_code": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "Two-letter country code."
    }
  }
}

wakatime_get_public_leaders

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1. Pass the previous reply's next_page.
language	string	Only this language.
board_type	string	Ranking: time (hours coded, default), manual (excluding AI coding), ai (AI lines) or spend (AI spend).
is_hireable	boolean	Only coders with the hireable badge.
country_code	string	Two-letter country code.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1. Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "language": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1,
      "description": "Only this language."
    },
    "board_type": {
      "enum": [
        "time",
        "manual",
        "ai",
        "spend"
      ],
      "type": "string",
      "description": "Ranking: time (hours coded, default), manual (excluding AI coding), ai (AI lines) or spend (AI spend)."
    },
    "is_hireable": {
      "type": "boolean",
      "description": "Only coders with the hireable badge."
    },
    "country_code": {
      "type": "string",
      "maxLength": 2,
      "minLength": 2,
      "description": "Two-letter country code."
    }
  }
}

wakatime_get_stats

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

read-only

Argument	Type	Description
range	string	Time range: last_7_days, last_30_days, last_6_months, last_year, all_time, a year (2026) or a month (2026-09).
timeout	integer	Keystroke timeout in minutes (default: the user's preference).
writes_only	boolean	Only count heartbeats that were file writes (default: the user's preference).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "range": {
      "type": "string",
      "default": "last_7_days",
      "pattern": "^(?:last_7_days|last_30_days|last_6_months|last_year|all_time|\\d{4}|\\d{4}-(?:0[1-9]|1[0-2]))$",
      "description": "Time range: last_7_days, last_30_days, last_6_months, last_year, all_time, a year (2026) or a month (2026-09)."
    },
    "timeout": {
      "type": "integer",
      "maximum": 1440,
      "description": "Keystroke timeout in minutes (default: the user's preference).",
      "exclusiveMinimum": 0
    },
    "writes_only": {
      "type": "boolean",
      "description": "Only count heartbeats that were file writes (default: the user's preference)."
    }
  }
}

wakatime_get_status_bar_today

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

wakatime_get_summaries

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.

read-only

Argument	Type	Description
end	string	Last day, yyyy-mm-dd, inclusive (with start).
range	string	Alternative to start and end.
start	string	First day, yyyy-mm-dd (with end).
project	string	Only time logged to this project.
timeout	integer	Keystroke timeout in minutes (default: the user's preference).
branches	string	Comma separated branch names; needs project.
timezone	string	IANA timezone such as Europe/Berlin (default: the user's timezone).
writes_only	boolean	Only count heartbeats that were file writes (default: the user's preference).

wakatime_get_user

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

wakatime_list_commits

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1. Pass the previous reply's next_page.
author	string	Only commits by this author (WakaTime username).
branch	string	Branch (default: the repository's default branch).
project*	string	Project name exactly as WakaTime shows it (see wakatime_list_projects).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "project"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1. Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "author": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Only commits by this author (WakaTime username)."
    },
    "branch": {
      "type": "string",
      "maxLength": 250,
      "minLength": 1,
      "description": "Branch (default: the repository's default branch)."
    },
    "project": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Project name exactly as WakaTime shows it (see wakatime_list_projects)."
    }
  }
}

wakatime_list_goals

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1. Pass the previous reply's next_page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1. Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    }
  }
}

wakatime_list_machines

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

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

wakatime_list_org_dashboard_members

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1. Pass the previous reply's next_page.
org_id*	string	Organization id.
dashboard_id*	string	Dashboard id (from wakatime_list_org_dashboards).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "org_id",
    "dashboard_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1. Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "org_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Organization id."
    },
    "dashboard_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Dashboard id (from wakatime_list_org_dashboards)."
    }
  }
}

wakatime_list_org_dashboards

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

read-only

Argument	Type	Description
page	integer	Page number, from 1. Pass the previous reply's next_page.
org_id*	string	Organization id (from wakatime_list_orgs).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "org_id"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1. Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    },
    "org_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Organization id (from wakatime_list_orgs)."
    }
  }
}

wakatime_list_orgs

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1. Pass the previous reply's next_page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1. Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    }
  }
}

wakatime_list_private_leaderboards

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1. Pass the previous reply's next_page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1. Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    }
  }
}

wakatime_list_projects

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.

read-only

Argument	Type	Description
q	string	Filter project names by this search term.
page	integer	Page number, from 1. Pass the previous reply's next_page.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "q": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Filter project names by this search term."
    },
    "page": {
      "type": "integer",
      "maximum": 100000,
      "description": "Page number, from 1. Pass the previous reply's next_page.",
      "exclusiveMinimum": 0
    }
  }
}

wakatime_list_user_agents

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "org_id",
    "dashboard_id",
    "member_id"
  ],
  "properties": {
    "end": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "Last day, yyyy-mm-dd, inclusive (with start)."
    },
    "range": {
      "enum": [
        "Today",
        "Yesterday",
        "Last 7 Days",
        "Last 7 Days from Yesterday",
        "Last 14 Days",
        "Last 30 Days",
        "This Week",
        "Last Week",
        "This Month",
        "Last Month"
      ],
      "type": "string",
      "description": "Alternative to start and end."
    },
    "start": {
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$",
      "description": "First day, yyyy-mm-dd (with end)."
    },
    "org_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Organization id."
    },
    "project": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Only time logged to this project."
    },
    "branches": {
      "type": "string",
      "maxLength": 500,
      "minLength": 1,
      "description": "Comma separated branch names; needs project."
    },
    "member_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Member id (from wakatime_list_org_dashboard_members)."
    },
    "dashboard_id": {
      "type": "string",
      "maxLength": 200,
      "minLength": 1,
      "description": "Dashboard id."
    }
  }
}