# Toggl

Toggl is a time tracking application that helps users monitor and manage their work hours efficiently.

- **Category:** time tracking software
- **Auth:** API_KEY
- **Composio Managed App Available?** N/A
- **Tools:** 56
- **Triggers:** 0
- **Slug:** `TOGGL`
- **Version:** 20260227_00

## Tools

### Create Client

**Slug:** `TOGGL_CREATE_CLIENT`

Tool to create a new client in a workspace. Use when you need to add a client to a workspace after workspace setup.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the client to create |
| `notes` | string | No | Additional notes about the client |
| `workspace_id` | integer | Yes | ID of the workspace where the client will be created |
| `external_reference` | string | No | External reference identifier for integration purposes |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Group

**Slug:** `TOGGL_CREATE_GROUP`

Tool to create a new group in a Toggl organization. Use when organizing users into teams and controlling access to workspaces. Groups help manage user permissions and workspace assignments at the organization level.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Group name; 1-200 characters |
| `users` | array | No | List of user IDs to add to the group; must exist in the organization |
| `workspaces` | array | Yes | List of workspace IDs to assign to the group; must exist in the organization |
| `organization_id` | integer | Yes | Numeric ID of the organization where the group will be created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Invitation

**Slug:** `TOGGL_CREATE_INVITATION`

Tool to send invitations to join a Toggl organization. Use when you need to invite users by email to an organization and its workspaces. At least one email and one workspace (or project_invite) are required.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `emails` | array | Yes | List of email addresses to send invitations to. At least one email is required. |
| `groups` | array | No | List of group IDs to add invited users to |
| `skip_email` | boolean | No | Whether to skip sending invitation emails. If true, invitation URLs are generated but emails are not sent. |
| `workspaces` | array | No | List of workspaces to invite users to. At least one workspace is required if project_invite is not specified. |
| `project_invite` | object | No | Model representing project invitation details. |
| `organization_id` | integer | Yes | ID of the organization to send invitations from |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Organization

**Slug:** `TOGGL_CREATE_ORGANIZATION`

Tool to create a new organization with a default workspace in Toggl Track. Use when initializing a new organization and workspace in one step. The authenticated user becomes the organization owner.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new organization; 1–100 characters. |
| `workspace_name` | string | Yes | Name of the default workspace; 1–100 characters. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Project

**Slug:** `TOGGL_CREATE_PROJECT`

Creates a new project in a Toggl workspace. Projects are used to organize time entries and track work for specific initiatives. Required parameters: workspace_id (integer) and name (string). Optional parameters include client assignment, privacy settings, billable status, and time estimates. Note: Some features (custom colors, templates, fixed fees, hourly rates) require a premium Toggl plan.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new project |
| `rate` | number | No | Default hourly rate for this project in chosen currency (premium feature) |
| `color` | string | No | Project color as a hex string (e.g., '#FF5733'). Custom colors require a premium plan; otherwise defaults to standard color. |
| `active` | boolean | No | Whether the project is active (true) or archived (false) |
| `billable` | boolean | No | Default billable status for entries in this project |
| `currency` | string | No | ISO currency code for fixed fee and hourly rate |
| `template` | boolean | No | Mark this project as a template for future use (premium feature) |
| `client_id` | integer | No | ID of the client the project belongs to |
| `fixed_fee` | number | No | Fixed-price fee for this project in chosen currency (premium feature) |
| `is_private` | boolean | No | Whether the project is private (true) or public (false) |
| `template_id` | integer | No | ID of an existing template project to base this project on |
| `workspace_id` | integer | Yes | ID of the workspace where the project will be created |
| `estimated_hours` | integer | No | Estimated total hours for the project |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Tag

**Slug:** `TOGGL_CREATE_TAG`

Tool to create a new tag in a workspace. Use when you need to add a tag after confirming workspace ID and desired tag name.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the new tag |
| `client_id` | integer | No | Optional client ID to associate with the tag |
| `workspace_id` | integer | Yes | ID of the workspace where the tag will be created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Create Time Entry

**Slug:** `TOGGL_CREATE_TIME_ENTRY`

Tool to create a new time entry in the specified workspace. Use when you have workspace ID, start time, and client name ready.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `stop` | string | No | ISO 8601 timestamp when the entry stopped; omit to leave running |
| `tags` | array | No | List of tags to attach to the entry |
| `start` | string | Yes | ISO 8601 timestamp when the entry started |
| `task_id` | integer | No | Task ID associated with the time entry |
| `billable` | boolean | No | Whether the entry is billable |
| `duration` | integer | No | Duration in seconds; omit for running entries |
| `project_id` | integer | No | Project ID to associate the entry with |
| `description` | string | No | Description of the time entry |
| `created_with` | string | Yes | Name of the client application creating this entry |
| `workspace_id` | integer | Yes | Workspace ID where the time entry will be created |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Add User to Workspace Project

**Slug:** `TOGGL_CREATE_WORKSPACES_PROJECT_USERS`

Tool to add a user to workspace project users. Use when you need to assign a user to a project within a workspace with optional manager privileges and custom rates.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `rate` | number | No | Rate for this project user |
| `manager` | boolean | No | Whether the user will be manager of the project |
| `user_id` | integer | Yes | User ID |
| `labor_cost` | number | No | Labor cost for this project user |
| `project_id` | integer | Yes | Project ID |
| `workspace_id` | integer | Yes | Numeric ID of the workspace |
| `rate_change_mode` | string ("start-today" | "override-current" | "override-all") | No | Mode for applying rate changes to the project user. |
| `labor_cost_change_mode` | string ("start-today" | "override-current" | "override-all") | No | Mode for applying labor cost changes to the project user. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Toggl Client

**Slug:** `TOGGL_DELETE_CLIENT`

Tool to delete a client in Toggl. Use when you have confirmed the workspace and client IDs and want to remove a client permanently.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `client_id` | string | Yes | The ID of the client to delete. |
| `workspace_id` | string | Yes | The ID of the workspace where the client resides. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Group

**Slug:** `TOGGL_DELETE_GROUP`

Tool to delete a group from a Toggl organization. Use when you need to permanently remove a group and its associated permissions. Requires organization and group IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `group_id` | integer | Yes | Numeric ID of the group. |
| `organization_id` | integer | Yes | Numeric ID of the organization. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Project Group

**Slug:** `TOGGL_DELETE_PROJECT_GROUP`

Tool to delete a project group from a Toggl workspace. Use when you need to remove a project group permanently. Requires workspace and project group IDs.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | integer | Yes | Numeric ID of the workspace containing the project group. |
| `project_group_id` | integer | Yes | Numeric ID of the project group to delete. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Subscription

**Slug:** `TOGGL_DELETE_SUBSCRIPTION`

Tool to delete a webhook subscription in Toggl. Use when you want to remove an existing subscription for a specific workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | integer | Yes | Numeric ID of the workspace |
| `subscription_id` | integer | Yes | Numeric ID of the subscription |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Delete Tag

**Slug:** `TOGGL_DELETE_TAG`

Deletes a tag from a Toggl workspace. Requires workspace and tag IDs. Only workspace or organization administrators can delete tags. Returns success status upon deletion.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `tag_id` | integer | Yes | Numeric ID of the tag to delete. |
| `workspace_id` | integer | Yes | Numeric ID of the workspace containing the tag. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Disable Weekly Report

**Slug:** `TOGGL_DISABLE_WEEKLY_REPORT`

Tool to disable weekly report email notifications. Use when you want to unsubscribe from weekly reports using the code provided in report emails.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `weekly_report_code` | string | Yes | Weekly report unsubscribe code (typically received in weekly report emails) |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Bulk Edit Time Entries

**Slug:** `TOGGL_EDIT_TIME_ENTRIES`

Tool to bulk edit multiple time entries in a workspace using JSON Patch operations. Use when you need to update the same field(s) across multiple time entries at once (e.g., changing descriptions, billable status, or project associations). Maximum 100 time entries per request.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `meta` | boolean | No | If true, include metadata for related entities (projects, tags, etc.) in the response |
| `patch_input` | array | Yes | Array of JSON Patch operations to apply to the specified time entries. Each operation modifies a specific field. At least one operation is required. |
| `workspace_id` | integer | Yes | Numeric ID of the workspace containing the time entries |
| `time_entry_ids` | string | Yes | Comma-separated list of time entry IDs to edit. Maximum 100 IDs per request. Example: '204301830,202700150,202687559' |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get All Plans

**Slug:** `TOGGL_GET_ALL_PLANS`

Tool to retrieve all available Toggl subscription plans and their features. Use when you need to display plan options, compare plans, or check available features for different subscription tiers.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Client Details

**Slug:** `TOGGL_GET_CLIENT_DETAILS`

Retrieves detailed information about a specific client in Toggl Track by its client ID and workspace ID. Use this tool when you need to: - Get complete client details including name, notes, and metadata - Verify if a client exists in a workspace - Check client archive status, timestamps, or external references - Retrieve integration information for JIRA/Salesforce linked clients

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `client_id` | integer | Yes | The unique client ID to retrieve. Must be a positive integer. Returns 404 if client not found. |
| `workspace_id` | integer | Yes | The workspace ID where the client is located. Must be a positive integer. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Countries

**Slug:** `TOGGL_GET_COUNTRIES`

Tool to retrieve all countries supported by Toggl. Returns country details including tax information, default currencies, and postal code requirements. Use when you need to validate country data or retrieve country-specific settings for billing.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Country Subdivisions

**Slug:** `TOGGL_GET_COUNTRY_SUBDIVISIONS`

Tool to retrieve all subdivisions (states, provinces, regions) for a specific country in Toggl Track. Use when you need to get geographical subdivision data for a country, such as US states or Canadian provinces.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `country_id` | integer | Yes | The unique country ID to retrieve subdivisions for. Must be a positive integer. Returns 404 if country not found. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Currencies

**Slug:** `TOGGL_GET_CURRENCIES`

Tool to retrieve the list of all currencies supported by Toggl Track. Use when you need currency codes and symbols for financial operations or display.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Current Time Entry

**Slug:** `TOGGL_GET_CURRENT_TIME_ENTRY`

Retrieves the currently running time entry for the authenticated user. Returns null if no timer is active. Use this to check timer status or get details about the active time entry.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Event Filters

**Slug:** `TOGGL_GET_EVENT_FILTERS`

Retrieve the list of supported event filters for Toggl webhooks. Use this when you need to know which event types are available for webhook subscriptions (e.g., client created, project updated, time entry deleted).

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get JWKS Keys

**Slug:** `TOGGL_GET_KEYS`

Retrieves the current JWKS (JSON Web Key Set) keyset used to sign JWT tokens. Use this to obtain public keys for verifying JWT token signatures issued by Toggl.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Clients

**Slug:** `TOGGL_GET_LIST_CLIENTS`

Retrieve a list of clients from a Toggl Track workspace with optional filtering by status and name. Use this tool to: - List all clients in a workspace - Filter clients by active/archived status - Search for clients by name (case-insensitive) - Get client details including IDs, names, timestamps, and permissions By default, only active clients are returned unless specified otherwise.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | No | Filter by client name (case-insensitive search). Returns all clients whose names contain this string. |
| `status` | string | No | Filter by client status: 'active' for active clients only, 'archived' for archived clients only, 'both' for all clients. Defaults to 'active' if not specified. |
| `workspace_id` | integer | Yes | The unique ID of the workspace to list clients from |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get My Location

**Slug:** `TOGGL_GET_MY_LOCATION`

Retrieves the authenticated user's last known location information including city, state, country, and coordinates. Use this to determine user's geographic location for timezone or region-specific features.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get My Quota

**Slug:** `TOGGL_GET_MY_QUOTA`

Tool to retrieve API rate limit quota for the authenticated user. Use when you need to check remaining API calls before making further requests or to monitor rate limit status.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Details

**Slug:** `TOGGL_GET_ORGANIZATION_DETAILS`

Retrieves detailed information about a specific Toggl organization including subscription plan, trial status, user count, and workspace settings. Requires a valid organization ID that the authenticated user has access to.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | integer | Yes | The unique numeric identifier of the Toggl organization. Must be a positive integer. You can obtain organization IDs from workspace details or by listing user workspaces. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Groups

**Slug:** `TOGGL_GET_ORGANIZATION_GROUPS`

Retrieves all groups within a Toggl organization, including group members and workspace assignments. Groups are used to organize users and control access to workspaces. Returns an empty list if no groups exist in the organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `organization_id` | integer | Yes | Unique identifier of the organization |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Organization Users

**Slug:** `TOGGL_GET_ORGANIZATION_USERS`

Retrieves a list of users belonging to a Toggl organization. Returns detailed information about each user including their email, name, role, workspace memberships, and group memberships. Supports filtering by name/email, status (active/inactive/invited), admin privileges, and pagination. Use this when you need to list organization members or find specific users within an organization.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (default: 1) |
| `filter` | string | No | Search filter to match users by name or email substring |
| `groups` | string | No | Comma-separated list of group IDs to filter users by group membership |
| `per_page` | integer | No | Number of results per page (default: 50, max: 200) |
| `sort_dir` | string | No | Sort direction for results by name: 'asc' or 'desc' |
| `workspaces` | string | No | Comma-separated list of workspace IDs to filter users by workspace membership |
| `only_admins` | boolean | No | If true, return only users with administrative privileges |
| `active_status` | string | No | Comma-separated list of statuses to filter by: 'active', 'inactive', or 'invited' |
| `organization_id` | integer | Yes | The unique ID of the organization to list users for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Project Details

**Slug:** `TOGGL_GET_PROJECT_DETAILS`

Tool to retrieve details of a specific project. Use after confirming the workspace ID and project ID.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `project_id` | integer | Yes | Unique identifier of the project to retrieve |
| `workspace_id` | integer | Yes | Workspace ID the project belongs to |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Projects

**Slug:** `TOGGL_GET_PROJECTS`

Tool to retrieve a list of projects from a Toggl workspace. Use after confirming workspace ID. Returns filtered and paginated projects with optional client details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (minimum is 1) |
| `since` | integer | No | Return projects modified after this Unix timestamp in seconds since epoch (integer). You can also provide an ISO 8601 string which will be automatically converted. Note: Toggl API only allows timestamps within the last 3 months. |
| `until` | integer | No | Return projects modified before this Unix timestamp in seconds since epoch (integer). You can also provide an ISO 8601 string which will be automatically converted. |
| `clients` | boolean | No | Include full client details when true |
| `user_id` | integer | No | Filter projects visible by this user ID |
| `page_size` | integer | No | Number of projects per page (1-200) |
| `project_ids` | string | No | Comma-separated list of project IDs to filter (max 200 IDs) |
| `workspace_id` | integer | Yes | The unique ID of the workspace to list projects from |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Public Subscription Plans

**Slug:** `TOGGL_GET_PUBLIC_SUBSCRIPTION_PLANS`

Tool to retrieve all publicly available subscription plans from Toggl. Use when you need to display available pricing tiers or plan options to users.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Webhooks Status

**Slug:** `TOGGL_GET_STATUS`

Tool to retrieve the Toggl Webhooks server status. Use when you need to check if the webhooks service is operational before registering or managing webhook subscriptions.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Tags

**Slug:** `TOGGL_GET_TAGS`

Retrieve all tags in a Toggl workspace. Returns a list of tags with their IDs, names, and metadata. Use this when you need to list available tags for categorizing time entries or when searching for a specific tag by name. Returns an empty list if the workspace has no tags.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | integer | Yes | The ID of the workspace to retrieve tags for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### List Tasks

**Slug:** `TOGGL_GET_TASKS`

Tool to list tasks in a workspace or within a specific project.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `page` | integer | No | Page number for pagination (minimum is 1) |
| `active` | boolean | No | If true, returns only active tasks |
| `billable` | boolean | No | If true, returns only billable tasks |
| `page_size` | integer | No | Number of tasks per page (1-1000) |
| `project_id` | integer | No | Filter tasks to only those belonging to this project ID |
| `workspace_id` | integer | Yes | Workspace ID to list tasks from |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Time Entries

**Slug:** `TOGGL_GET_TIME_ENTRIES`

Retrieve time entries for the authenticated user with flexible filtering options. Use this tool to: - List all recent time entries (no parameters needed) - Filter entries by date range (start_date + end_date) - Get entries modified since a specific time (since parameter for syncing) - Include project/tag metadata and sharing information Returns comprehensive details including project names, tags, duration, and billable status.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `meta` | boolean | No | Include metadata for related entities (projects, tags, etc.). Provides additional context. |
| `since` | integer | No | Retrieve entries modified since this UNIX timestamp (includes deleted entries). Useful for syncing changes. |
| `before` | string | No | Filter entries with start times before this date. Format: YYYY-MM-DD or RFC3339. Alternative to end_date. |
| `end_date` | string | No | Filter entries with start times before or on this date. Format: YYYY-MM-DD or ISO 8601 (e.g., '2024-01-31' or '2024-01-31T23:59:59Z'). Must be used with start_date. |
| `start_date` | string | No | Filter entries with start times on or after this date. Format: YYYY-MM-DD or ISO 8601 (e.g., '2024-01-01' or '2024-01-01T00:00:00Z'). Must be used with end_date. |
| `include_sharing` | boolean | No | Include sharing information in the response (shared_with field). |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Time Entry

**Slug:** `TOGGL_GET_TIME_ENTRY`

Tool to retrieve a specific time entry by its ID. Use when you have the entry ID and need its full details.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `time_entry_id` | integer | Yes | The unique ID of the time entry to retrieve |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Timezone Offsets

**Slug:** `TOGGL_GET_TIMEZONE_OFFSETS`

Tool to retrieve all available timezone offsets from Toggl. Use when you need to display timezone information or validate timezone selection for time entry operations.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Timezones

**Slug:** `TOGGL_GET_TIMEZONES`

Tool to retrieve all available timezones supported by Toggl Track. Use when you need to validate timezone values or display available timezone options to users.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Clients

**Slug:** `TOGGL_GET_USER_CLIENTS`

Retrieves all clients accessible to the authenticated user across all their workspaces. Returns a complete list of client details including workspace associations, archive status, notes, and integration information. Use this to view all clients the current user has access to without needing to specify individual workspace IDs.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Preferences

**Slug:** `TOGGL_GET_USER_PREFERENCES`

Retrieves the authenticated user's preferences including timezone, date/time formats, notification settings, and enabled alpha/experimental features. Useful for understanding user display preferences or checking which optional features are available.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Projects

**Slug:** `TOGGL_GET_USER_PROJECTS`

Tool to retrieve all projects for the authenticated user. Use after authenticating to list available projects.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | integer | No | Only return projects for the specified workspace ID |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Tags

**Slug:** `TOGGL_GET_USER_TAGS`

Tool to retrieve tags associated with the current user. Use when you need to list all tags visible to your account across all workspaces, or to get tags that have been created/modified/deleted since a specific date for incremental syncing.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `since` | integer | No | Optional UNIX timestamp to retrieve tags that have been created, modified, or deleted since this date. Use this for incremental syncing. Note: The timestamp cannot be older than 3 months from the current date. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Tasks

**Slug:** `TOGGL_GET_USER_TASKS`

Retrieve all tasks across all workspaces accessible to the authenticated user. Returns tasks from projects the user can access, including task details like name, active status, estimated time, and tracked time. Use this to get a comprehensive list of tasks without needing to specify workspace or project IDs.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get User Workspaces

**Slug:** `TOGGL_GET_USER_WORKSPACES`

Tool to retrieve all workspaces the authenticated user belongs to. Use when you need to list accessible workspaces before performing workspace-specific operations. Verify the correct workspace ID from the returned list before use — an incorrect workspace ID will misroute entries and skew reports.

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Workspace Details

**Slug:** `TOGGL_GET_WORKSPACE_DETAILS`

Retrieves comprehensive details and settings for a specific Toggl workspace by ID. Returns workspace configuration including premium/business status, admin permissions, default settings for projects/billing, time tracking preferences, and organizational details. Use this when you need to inspect workspace properties or validate access before performing workspace-specific operations.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | integer | Yes | Unique ID of the workspace to retrieve details for |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Workspace Logo

**Slug:** `TOGGL_GET_WORKSPACE_LOGO`

Tool to get workspace logo. Use when you need to retrieve the logo associated with a specific workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | integer | Yes | Numeric ID of the workspace |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Workspace Preferences

**Slug:** `TOGGL_GET_WORKSPACE_PREFERENCES`

Retrieves workspace preferences including the initial pricing plan and whether start/end times are hidden. Use this after obtaining a workspace ID to check workspace-level preference settings.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | integer | Yes | The unique identifier of the workspace |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Get Workspace Users

**Slug:** `TOGGL_GET_WORKSPACE_USERS`

Retrieves all users who belong to a specific Toggl workspace. Returns user details including their name, email, admin status, and activity status. Use this to list workspace members, check user roles, or verify user access to a workspace.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | integer | Yes | The workspace ID to retrieve users from. You can get workspace IDs using the Get User Workspaces action. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Stop Time Entry

**Slug:** `TOGGL_PATCH_STOP_TIME_ENTRY`

Tool to stop a running time entry in a workspace. Use when a time entry needs to be ended.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `workspace_id` | integer | Yes | ID of the workspace containing the time entry |
| `time_entry_id` | integer | Yes | ID of the time entry to stop Must belong to a currently running entry; stopping an already-stopped or wrong entry corrupts time-tracking history. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Disable Product Emails

**Slug:** `TOGGL_POST_ME_DISABLE_PRODUCT_EMAILS`

Tool to disable product emails for the authenticated user using a disable code. Use when the user wants to unsubscribe from Toggl product emails using a code from an unsubscribe link.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `disable_code` | string | Yes | Unique disable code to unsubscribe from product emails. This code is typically obtained from email unsubscribe links and is a 32-character hexadecimal hash. |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Tag

**Slug:** `TOGGL_PUT_UPDATE_TAG`

Tool to update an existing tag in a specified workspace. Use after confirming the workspace_id and tag_id when renaming a tag. Example: rename tag 'urgent' to 'high_priority'.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | New name for the tag |
| `tag_id` | integer | Yes | Numeric ID of the tag to update |
| `workspace_id` | integer | Yes | Numeric ID of the workspace containing the tag |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Demo Email

**Slug:** `TOGGL_SEND_DEMO_EMAIL`

Tool to send a demo request email through Toggl's system. Use when someone wants to request a product demo.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `Email` | string | Yes | Email address of the person requesting the demo |
| `Phone` | string | Yes | Phone number of the person requesting the demo |
| `Source` | string | Yes | Source of the demo request (e.g., website, API, referral) |
| `Purpose` | string | Yes | Purpose or reason for requesting the demo |
| `LastName` | string | Yes | Last name of the person requesting the demo |
| `TeamSize` | string | Yes | Size of the team that will use the product |
| `FirstName` | string | Yes | First name of the person requesting the demo |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Email to Contact

**Slug:** `TOGGL_SEND_EMAIL_CONTACT`

Tool to send an email to a contact via Toggl's smail service. Use when you need to send a message to a specific contact by providing their email, name, and message content.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `name` | string | Yes | Name of the contact recipient |
| `email` | string | Yes | Email address of the recipient |
| `message` | string | Yes | Message content to send in the email |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Send Smail Meet

**Slug:** `TOGGL_SEND_SMAIL_MEET`

Tool to send an email for meet. Use when you need to send a meet invitation email to a specific recipient with a location.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `email` | string | Yes | Email address to send the meet invitation to |
| `location` | string | Yes | Location for the meet |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |

### Update Client

**Slug:** `TOGGL_UPDATE_CLIENT`

Updates an existing client in a Toggl workspace. Use this to modify a client's name or notes. Note: The Toggl API requires the 'name' field when updating any client property.

#### Input Parameters

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `wid` | integer | No | Workspace ID (must match workspace_id if provided, rarely needed) |
| `name` | string | No | New name for the client. Note: The Toggl API requires the name field to be provided when updating any client property. |
| `notes` | string | No | Additional notes or description for the client |
| `client_id` | integer | Yes | The unique ID of the client to update |
| `workspace_id` | integer | Yes | The unique ID of the workspace that owns the client |

#### Output

| Parameter | Type | Required | Description |
|-----------|------|----------|-------------|
| `data` | object | Yes | Data from the action execution |
| `error` | string | No | Error if any occurred during the execution of the action |
| `successful` | boolean | Yes | Whether or not the action execution was successful or not |
