WakaTime MCP by usefulapi

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.

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

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.

{
  "type": "object",
  "properties": {
    "start": {
      "description": "First day, yyyy-mm-dd (with end).",
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
    },
    "end": {
      "description": "Last day, yyyy-mm-dd, inclusive (with start).",
      "type": "string",
      "pattern": "^(\\d{4})-(\\d{2})-(\\d{2})$"
    },
    "range": {
      "type": "string",
      "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"
      ],
      "description": "Alternative to start and end."
    },
    "project": {
      "description": "Only time logged to this project.",
      "type": "string",
      "minLength": 1,
      "maxLength": 500
    },
    "branches": {
      "type": "string",
      "minLength": 1,
      "maxLength": 500,
      "description": "Comma separated branch names; needs project."
    },
    "timezone": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "pattern": "^[A-Za-z0-9_+\\-/]+$",
      "description": "IANA timezone such as Europe/Berlin (default: the user's timezone)."
    },
    "timeout": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 1440,
      "description": "Keystroke timeout in minutes (default: the user's preference)."
    },
    "writes_only": {
      "type": "boolean",
      "description": "Only count heartbeats that were file writes (default: the user's preference)."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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

{
  "type": "object",
  "properties": {
    "range": {
      "default": "last_7_days",
      "type": "string",
      "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",
      "exclusiveMinimum": 0,
      "maximum": 1440,
      "description": "Keystroke timeout in minutes (default: the user's preference)."
    },
    "writes_only": {
      "type": "boolean",
      "description": "Only count heartbeats that were file writes (default: the user's preference)."
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

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

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.

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

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

{
  "type": "object",
  "properties": {
    "insight_type": {
      "type": "string",
      "enum": [
        "stats",
        "weekdays",
        "days",
        "ai_days",
        "best_day",
        "daily_average",
        "projects",
        "languages",
        "editors",
        "categories",
        "machines",
        "operating_systems"
      ]
    },
    "range": {
      "default": "last_year",
      "type": "string",
      "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)."
    },
    "weekday": {
      "description": "Only for insight_type 'days': a weekday, 0-6 or monday..sunday.",
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0,
          "maximum": 6
        },
        {
          "type": "string",
          "enum": [
            "monday",
            "tuesday",
            "wednesday",
            "thursday",
            "friday",
            "saturday",
            "sunday"
          ]
        }
      ]
    },
    "timeout": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 1440,
      "description": "Keystroke timeout in minutes (default: the user's preference)."
    },
    "writes_only": {
      "type": "boolean",
      "description": "Only count heartbeats that were file writes (default: the user's preference)."
    }
  },
  "required": [
    "insight_type"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

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

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.

{
  "type": "object",
  "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": {
      "description": "Return at most this many heartbeats (default 200).",
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 2000
    },
    "offset": {
      "description": "Skip this many heartbeats first (to read a busy day in slices; default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 1000000
    }
  },
  "required": [
    "date"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

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.

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

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

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

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.

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

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.

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

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

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

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.

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

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

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

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.

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

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

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

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.

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

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.

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

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.

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

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.

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

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

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

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.

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