# Toggl

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

- **Category:** time tracking software
- **Auth:** API_KEY
- **Tools:** 31
- **Triggers:** 0
- **Slug:** `TOGGL`
- **Version:** 20260211_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.

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

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

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

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

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

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

### 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

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

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

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

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

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

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

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

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

### List Tasks

**Slug:** `TOGGL_GET_TASKS`

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

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

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

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

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

### Get User Projects

**Slug:** `TOGGL_GET_USER_PROJECTS`

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

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

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

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

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

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

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

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

### 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'.

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