Skip to main content
WakaTime logo
  • Category: time tracking software
  • Auth: OAUTH2
  • Composio-managed OAuth available? Yes
  • Tools: 17
  • Triggers: 0
  • Slug: WAKATIME
  • Version: 20261101_00

Tools

Slug: WAKATIME_GET_AGGREGATE_STATSTool 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

string
required
Time range for aggregate stats; either ‘last_7_days’ or a specific year (e.g., ‘2023’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_GET_CURRENT_USER_STATUS_BAR_TODAYGet 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

string
Filter results to a specific project by name. When provided, includes branches and entities fields in response.
integer
Keystroke timeout value in minutes; overrides user’s default setting. Determines how long between keystrokes before activity is considered a different session.
string
Comma-separated list of branch names to include in results. Filters activity to only these branches.
string
Timezone for the requested day in Olson format (e.g., ‘America/Los_Angeles’). Defaults to user’s timezone setting.
boolean
When true, only counts file write events (not just cursor movement). Defaults to user’s preference setting.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_GET_EDITORSTool to list WakaTime IDE plugins with metadata. Use when you want to discover available IDE integrations and their latest versions.

Input Parameters

boolean
Include unreleased IDE plugins in the returned list.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_GET_GOALSTool to list a user’s goals with progress series and metadata. Use after authenticating the user with read_goals scope.

Input Parameters

string
User identifier; use ‘current’ for the authenticated user or specify a user ID

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_GET_INSIGHTSRetrieve 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

string
required
User identifier path segment; use ‘current’ for the authenticated user or specify a user ID
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
integer
Keystroke timeout in seconds for stats; defaults to the user’s setting
string
Filter to a specific weekday; only applied when insight_type is ‘days’; Accepts 0–6 or weekday name
boolean
Whether to include only write events in stats; defaults to the user’s setting
string ("weekday" | "days" | "best_day" | "daily_average" | "projects" | "languages" | "editors" | "categories" | "machines" | "operating_systems")
required
Type of insight to retrieve

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_GET_LEADERSTool 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

integer
Page number to fetch; authenticated calls default to page containing current user
string
Filter leaders by a specific language (e.g., ‘python’)
boolean
Filter leaders by hireable badge
string
Filter leaders by a two-letter country code (e.g., ‘US’)

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_GET_MACHINE_NAMESTool to list a user’s machines including last seen time. Use when needing machine names for a specific user.

Input Parameters

string
User identifier. Defaults to ‘current’ for the authenticated user. Can also be a specific user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_GET_METATool 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

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_GET_OAUTH_AUTHORIZETool to generate OAuth 2.0 authorization URL. Use when redirecting users to WakaTime to grant access.

Input Parameters

string
Space- or comma-separated list of scopes to request (e.g., ‘read_stats write_data’).
string
Opaque value to maintain state between request and callback; returned unchanged.
string
required
Your WakaTime App ID (found at wakatime.com/apps).
string
required
Redirect URI registered in your WakaTime app settings.
string
If provided, forces the user to re-approve (behavior may vary).
string ("code" | "token")
required
Must be “code” for authorization-code flow or “token” for implicit flow.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_GET_USERRetrieve 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

string
required
User ID, username, or ‘current’ for the authenticated user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_GET_USERS_ALL_TIME_SINCE_TODAYRetrieve 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

string
required
User path segment. Use ‘current’ for the authenticated user.
string
Optional project name to filter totals

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_GET_USER_STATSRetrieve 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

string
required
User identifier; use ‘current’ for the authenticated user or specify a user ID.
integer
Override the user’s keystroke timeout setting (in minutes). If not specified, uses the user’s preference.
boolean
Override the user’s writes_only setting. When true, only track writing activity; when false, track all activity.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_GET_USER_STATS_BY_RANGERetrieve 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

string
required
User identifier; use ‘current’ for the authenticated user or specify a user ID
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)
integer
Override the user’s keystroke timeout setting (in minutes); defaults to user’s preference
boolean
Override the user’s writes_only setting; if true, only track write operations

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_GET_USER_SUMMARIESGet 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

string
End date of the time range in YYYY-MM-DD format. Required if ‘range’ parameter is not provided.
string
required
User ID or ‘current’ for the authenticated user.
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.
string
Start date of the time range in YYYY-MM-DD format. Required if ‘range’ parameter is not provided.
string
Filter results by specific project name.
integer
Override the user’s keystroke timeout setting in minutes. Controls how long between keystrokes before ending a coding session.
string
Filter by comma-separated list of branch names.
string
Override the user’s timezone in Olson format (e.g., ‘America/Los_Angeles’, ‘Europe/London’). Affects how days are segmented.
boolean
Override the user’s writes_only setting. If true, only count time when files are modified, not just viewed.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_LIST_PROGRAM_LANGUAGESList a page of verified programming languages supported by WakaTime, with language metadata and pagination totals.

Input Parameters

integer
Page number for pagination (1-indexed). Defaults to 1 if not specified.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_LIST_USER_PROJECTSList 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

string
Filter project names by search term. Case-insensitive partial match.
integer
Page number for paginated results. Defaults to 1 if not specified.
string
required
User ID or ‘current’ for the authenticated user.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not
Slug: WAKATIME_LIST_USER_USER_AGENTSTool 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

string
User identifier. Defaults to ‘current’ for the authenticated user. Can also be a specific user ID.

Output

string
required
Data from the action execution
string
Error if any occurred during the execution of the action
boolean
required
Whether or not the action execution was successful or not