> ## Documentation Index
> Fetch the complete documentation index at: https://composio-preview.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# WakaTime

> WakaTime offers automatic time tracking for developers, integrating with code editors and delivering dashboards on coding activity, project progress, and productivity

![WakaTime logo](https://mintcdn.com/composio-preview/DMB8UrgJmE7r-ZQ5/images/toolkits/wakatime.svg?fit=max\&auto=format\&n=DMB8UrgJmE7r-ZQ5\&q=85\&s=ef2020a2a57a8208e00f5e79b1023bb1)

* **Category:** time tracking software
* **Auth:** OAUTH2
* **Composio-managed OAuth available?** Yes
* **Tools:** 17
* **Triggers:** 0
* **Slug:** `WAKATIME`
* **Version:** 20261101\_00

## Tools

> [accordion] Get Aggregate Stats
>
> **Slug:** `WAKATIME_GET_AGGREGATE_STATS`
>
> 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.
>
> #### Input Parameters
>
> **range** `string` *required*
>
> Time range for aggregate stats; either 'last\_7\_days' or a specific year (e.g., '2023')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get current user's status bar summary for today
>
> **Slug:** `WAKATIME_GET_CURRENT_USER_STATUS_BAR_TODAY`
>
> Get the current user's cached coding activity summary for today, broken down by projects, languages, editors, and more. An empty summary may be returned while the cache updates.
>
> #### Input Parameters
>
> **project** `string`
>
> Filter results to a specific project by name. When provided, includes branches and entities fields in response.
>
> **timeout** `integer`
>
> Keystroke timeout value in minutes; overrides user's default setting. Determines how long between keystrokes before activity is considered a different session.
>
> **branches** `string`
>
> Comma-separated list of branch names to include in results. Filters activity to only these branches.
>
> **timezone** `string`
>
> Timezone for the requested day in Olson format (e.g., 'America/Los\_Angeles'). Defaults to user's timezone setting.
>
> **writes\_only** `boolean`
>
> When true, only counts file write events (not just cursor movement). Defaults to user's preference setting.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List IDE Plugins
>
> **Slug:** `WAKATIME_GET_EDITORS`
>
> Tool to list WakaTime IDE plugins with metadata. Use when you want to discover available IDE integrations and their latest versions.
>
> #### Input Parameters
>
> **unreleased** `boolean`
>
> Include unreleased IDE plugins in the returned list.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Goals
>
> **Slug:** `WAKATIME_GET_GOALS`
>
> Tool to list a user's goals with progress series and metadata. Use after authenticating the user with read\_goals scope.
>
> #### Input Parameters
>
> **user** `string`
>
> User identifier; use 'current' for the authenticated user or specify a user ID
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Insight
>
> **Slug:** `WAKATIME_GET_INSIGHTS`
>
> Retrieve a user's coding activity insight for a time range. A 402 response is returned as an error payload inside the data field rather than raised as an error; insights may also be stale while updating.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> User identifier path segment; use 'current' for the authenticated user or specify a user ID
>
> **range** `string` *required*
>
> Time range for the insight; either a year (YYYY), a month (YYYY-MM), or one of: last\_7\_days, last\_30\_days, last\_6\_months, last\_year, all\_time
>
> **timeout** `integer`
>
> Keystroke timeout in seconds for stats; defaults to the user's setting
>
> **weekday** `string`
>
> Filter to a specific weekday; only applied when insight\_type is 'days'; Accepts 0–6 or weekday name
>
> **writes\_only** `boolean`
>
> Whether to include only write events in stats; defaults to the user's setting
>
> **insight\_type** `string ("weekday" | "days" | "best_day" | "daily_average" | "projects" | "languages" | "editors" | "categories" | "machines" | "operating_systems")` *required*
>
> Type of insight to retrieve
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Leaders
>
> **Slug:** `WAKATIME_GET_LEADERS`
>
> Tool to list public leaders ranked by coding activity. Use when viewing top coders globally or filtering by language, country code, or hireable status.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number to fetch; authenticated calls default to page containing current user
>
> **language** `string`
>
> Filter leaders by a specific language (e.g., 'python')
>
> **is\_hireable** `boolean`
>
> Filter leaders by hireable badge
>
> **country\_code** `string`
>
> Filter leaders by a two-letter country code (e.g., 'US')
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Machine Names
>
> **Slug:** `WAKATIME_GET_MACHINE_NAMES`
>
> Tool to list a user's machines including last seen time. Use when needing machine names for a specific user.
>
> #### Input Parameters
>
> **user** `string`
>
> User identifier. Defaults to 'current' for the authenticated user. Can also be a specific user ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get API Meta Information
>
> **Slug:** `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 security purposes.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Generate WakaTime OAuth authorize URL
>
> **Slug:** `WAKATIME_GET_OAUTH_AUTHORIZE`
>
> Tool to generate OAuth 2.0 authorization URL. Use when redirecting users to WakaTime to grant access.
>
> #### Input Parameters
>
> **scope** `string`
>
> Space- or comma-separated list of scopes to request (e.g., 'read\_stats write\_data').
>
> **state** `string`
>
> Opaque value to maintain state between request and callback; returned unchanged.
>
> **client\_id** `string` *required*
>
> Your WakaTime App ID (found at wakatime.com/apps).
>
> **redirect\_uri** `string` *required*
>
> Redirect URI registered in your WakaTime app settings.
>
> **force\_approve** `string`
>
> If provided, forces the user to re-approve (behavior may vary).
>
> **response\_type** `string ("code" | "token")` *required*
>
> Must be "code" for authorization-code flow or "token" for implicit flow.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Details
>
> **Slug:** `WAKATIME_GET_USER`
>
> Retrieve a WakaTime user's profile by ID or username, or use current for the authenticated user. The profile includes display name, email, timezone, plan, and privacy settings; requests for other users can fail response validation.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> User ID, username, or 'current' for the authenticated user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User's Total Time Since Creation
>
> **Slug:** `WAKATIME_GET_USERS_ALL_TIME_SINCE_TODAY`
>
> Retrieve a user's total coding time since account creation, optionally for a project. Results may still be updating; check their freshness before interpreting the total.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> User path segment. Use 'current' for the authenticated user.
>
> **project** `string`
>
> Optional project name to filter totals
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Stats
>
> **Slug:** `WAKATIME_GET_USER_STATS`
>
> Retrieve a user's coding statistics for their public profile's default time range, including language, editor, project, and daily-average metrics. Results may be stale while statistics are recalculated.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> User identifier; use 'current' for the authenticated user or specify a user ID.
>
> **timeout** `integer`
>
> Override the user's keystroke timeout setting (in minutes). If not specified, uses the user's preference.
>
> **writes\_only** `boolean`
>
> Override the user's writes\_only setting. When true, only track writing activity; when false, track all activity.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Stats by Range
>
> **Slug:** `WAKATIME_GET_USER_STATS_BY_RANGE`
>
> Retrieve a user's coding statistics for a specified time range, including breakdowns by language, editor, project, and OS, daily averages, and best day. Results may be stale while statistics are recalculated.
>
> #### Input Parameters
>
> **user** `string` *required*
>
> User identifier; use 'current' for the authenticated user or specify a user ID
>
> **range** `string` *required*
>
> Time range for stats; accepts 'last\_7\_days', 'last\_30\_days', 'last\_6\_months', 'last\_year', 'all\_time', a specific year (YYYY), or a specific month (YYYY-MM)
>
> **timeout** `integer`
>
> Override the user's keystroke timeout setting (in minutes); defaults to user's preference
>
> **writes\_only** `boolean`
>
> Override the user's writes\_only setting; if true, only track write operations
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] Get User Summaries
>
> **Slug:** `WAKATIME_GET_USER_SUMMARIES`
>
> 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 project time, or generate activity reports over a date range. Requires 'read\_summaries' scope.
>
> #### Input Parameters
>
> **end** `string`
>
> End date of the time range in YYYY-MM-DD format. Required if 'range' parameter is not provided.
>
> **user** `string` *required*
>
> User ID or 'current' for the authenticated user.
>
> **range** `string ("Today" | "Yesterday" | "Last 7 Days" | "Last 7 Days from Yesterday" | "Last 14 Days" | "Last 30 Days" | "This Week" | "Last Week" | "This Month" | "Last Month")`
>
> Predefined date range options for summaries.
>
> **start** `string`
>
> Start date of the time range in YYYY-MM-DD format. Required if 'range' parameter is not provided.
>
> **project** `string`
>
> Filter results by specific project name.
>
> **timeout** `integer`
>
> Override the user's keystroke timeout setting in minutes. Controls how long between keystrokes before ending a coding session.
>
> **branches** `string`
>
> Filter by comma-separated list of branch names.
>
> **timezone** `string`
>
> Override the user's timezone in Olson format (e.g., 'America/Los\_Angeles', 'Europe/London'). Affects how days are segmented.
>
> **writes\_only** `boolean`
>
> Override the user's writes\_only setting. If true, only count time when files are modified, not just viewed.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List Program Languages
>
> **Slug:** `WAKATIME_LIST_PROGRAM_LANGUAGES`
>
> List a page of verified programming languages supported by WakaTime, with language metadata and pagination totals.
>
> #### Input Parameters
>
> **page** `integer`
>
> Page number for pagination (1-indexed). Defaults to 1 if not specified.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List User Projects
>
> **Slug:** `WAKATIME_LIST_USER_PROJECTS`
>
> 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.
>
> #### Input Parameters
>
> **q** `string`
>
> Filter project names by search term. Case-insensitive partial match.
>
> **page** `integer`
>
> Page number for paginated results. Defaults to 1 if not specified.
>
> **user** `string` *required*
>
> User ID or 'current' for the authenticated user.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not

> [accordion] List User Agents
>
> **Slug:** `WAKATIME_LIST_USER_USER_AGENTS`
>
> 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.
>
> #### Input Parameters
>
> **user** `string`
>
> User identifier. Defaults to 'current' for the authenticated user. Can also be a specific user ID.
>
> #### Output
>
> **data** `string` *required*
>
> Data from the action execution
>
> **error** `string`
>
> Error if any occurred during the execution of the action
>
> **successful** `boolean` *required*
>
> Whether or not the action execution was successful or not
