# WakaTime — MCP server on mcp.ai
> Connect your WakaTime account and use 17 tools for time tracking straight from your AI agent. Connect in one click, no API key needed. WakaTime offers automatic time tracking for developers, integrating with code editors and delivering dashboards on coding activity, project progress, and productivity.

By: mcp.ai · official
Page: https://mcp.ai/wakatime

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_wakatime?ms=1787291400000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/wakatime/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/wakatime/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/wakatime/skill.md
Postman collection (v2.1): https://mcp.ai/wakatime/postman.json

## Tools
- wakatime_get_aggregate_stats(range: string) — Tool to retrieve aggregate coding statistics across all WakaTime users for a given time range. Use when analyzing global trends in programming languages, editors, operating systems, and categories.
- wakatime_get_current_user_status_bar_today(project?: string, timeout?: integer, branches?: string, timezone?: string, writes_only?: boolean) — Tool to get current user's coding activity today for displaying in IDE status bars. Use when you need a summary of today's coding time broken down by projects, languages, editors, etc.
- wakatime_get_editors(unreleased?: boolean) — Tool to list WakaTime IDE plugins with metadata. Use when you want to discover available IDE integrations and their latest versions.
- wakatime_get_goals(user?: string) — Tool to list a user's goals with progress series and metadata. Use after authenticating the user with read_goals scope.
- wakatime_get_insights(user: string, range: string, timeout?: integer, weekday?: integer|string, writes_only?: boolean, insight_type: string) — Tool to retrieve an insight for a user over a time range. Use when analyzing user coding metrics after authentication.
- wakatime_get_leaders(page?: integer, language?: string, is_hireable?: boolean, country_code?: string) — Tool to list public leaders ranked by coding activity. Use when viewing top coders globally or filtering by language, country code, or hireable status.
- wakatime_get_machine_names(user?: string) — Tool to list a user's machines including last seen time. Use when needing machine names for a specific user.
- wakatime_get_meta() — Tool to retrieve WakaTime API meta information, including public IP addresses used by WakaTime servers. Use when you need to know WakaTime's infrastructure details for network configuration or securit
- wakatime_get_oauth_authorize(scope?: string, state?: string, client_id: string, redirect_uri: string, force_approve?: string, response_type: string) — Tool to generate OAuth 2.0 authorization URL. Use when redirecting users to WakaTime to grant access.
- wakatime_get_user(user: string) — Tool to get detailed profile information for a WakaTime user by user ID or username. Use 'current' as the user parameter to get the authenticated user's details. Returns comprehensive profile data inc
- wakatime_get_user_stats(user: string, timeout?: integer, writes_only?: boolean) — Tool to retrieve coding statistics for a user over the default time range. Returns comprehensive metrics including languages, editors, projects, and daily averages. Use when analyzing a user's coding 
- wakatime_get_user_stats_by_range(user: string, range: string, timeout?: integer, writes_only?: boolean) — Tool to retrieve comprehensive coding statistics for a user over a specific time range. Returns breakdowns by language, editor, project, OS, and more, along with daily averages and best day. Use when 
- wakatime_get_user_summaries(end?: string, user: string, range?: string, start?: string, project?: string, timeout?: integer, branches?: string, timezone?: string, writes_only?: boolean) — Get user's coding activity for a time range as daily summaries. Returns detailed breakdowns by projects, languages, editors, and more for each day. Use when you need to analyze coding patterns, track 
- wakatime_get_users_all_time_since_today(user: string, project?: string) — Tool to retrieve total coding time since account creation for a user. Use after authenticating to fetch all-time stats.
- wakatime_list_program_languages(page?: integer) — Tool to list all verified program languages supported by WakaTime. Use when you need to discover available programming languages tracked by WakaTime.
- wakatime_list_user_projects(q?: string, page?: integer, user: string) — List WakaTime projects for a specified user. Returns project names, IDs, creation dates, and last activity times. Use to discover available projects for any user before querying project-specific stats
- wakatime_list_user_user_agents(user?: string) — Tool to list plugins and editors which have sent data for a specified user. Use when needing to discover which development environments and tools a user is actively using.

## Example prompts
- "What can I do in WakaTime?"
- "Show me a summary of my WakaTime account"

## Links
Docs: https://mcp.ai/docs/mcps/wakatime
Website: https://mcp.ai/mcps/wakatime