The Toggl Track connector lets your AI agent work with Toggl Track. Scalekit handles authentication for every call, so your agent never handles credentials. It comes with 44 tools.
- Tools
- 44
- What they doRead · write · destructive
- 23 · 15 · 623 read15 write6 destructive
- Users sign in with
- API key
Setup
Install the SDK
Terminal window npm install @scalekit-sdk/node dotenvTerminal window pip install scalekit-sdk-python python-dotenvSet your credentials
Add your Scalekit credentials to your
.envfile. Find values in app.scalekit.com > Developers > API Credentials..env SCALEKIT_ENVIRONMENT_URL=<your-environment-url>SCALEKIT_CLIENT_ID=<your-client-id>SCALEKIT_CLIENT_SECRET=<your-client-secret>Create the Toggl Track connection
In AgentKit > Connections, create a Toggl Track connection. The name you give it is the
connection_nameyour code passes. See Configure connections.
Tools
Pass the exact name toexecute_tooltoggl_get_clientGet one client in a Toggl Track workspace by ID.Read-onlyGet Client
Get one client in a Toggl Track workspace by ID. Returns the client id, name, notes, archived flag, external_reference, and workspace id (wid). Use this for a known client. Use list_clients to find client IDs.
Inputs
client_idintegerrequired- Numeric ID of the client. Get it from the list clients tool. Example: 64123456.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
toggl_get_current_time_entryGet the connected user's currently running time entry.Read-onlyGet Running Time Entry
Get the connected user's currently running time entry. Returns the running time entry with id, workspace_id, project_id, description, start, and a negative duration; returns an empty result when no timer is running. Use this before stop_time_entry to find the running entry's id. Use get_time_entry for a specific entry by ID.
Inputs
This tool takes no inputs.
toggl_get_current_userGet the Toggl Track profile of the user who owns the connected API token.Read-onlyGet Current User
Get the Toggl Track profile of the user who owns the connected API token. Returns the user id, email, full name, time zone, beginning of week, and default_workspace_id; with related data on, also returns their clients, projects, tags, tasks, time entries, and workspaces. Use this to find the default workspace or confirm whose account is connected. Use list_workspaces for every workspace the user belongs to.
Inputs
with_related_databoolean- Set to true to also return the user's clients, projects, tasks, tags, workspaces and time entries in one response. Example: true.
toggl_get_detailed_reportRun a Toggl Track detailed report: individual time entries for a workspace in a date range, filtered by users, projects, clients, tags, tasks, or description.Read-onlyGet Detailed Report
Run a Toggl Track detailed report: individual time entries for a workspace in a date range, filtered by users, projects, clients, tags, tasks, or description. Returns the report rows (time entries for the detailed report, grouped when grouped is on); the reference documents no row schema, and results are paged 50 rows at a time. Use this for other users' time or long date ranges. Use get_summary_report for totals and list_time_entries for the connected user's own recent entries.
Inputs
start_datestringrequired- First day of the report, YYYY-MM-DD (inclusive, evaluated in each user's own time zone). Example: 2026-10-01.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
billableboolean- Only include billable (true) or non-billable (false) time (paid-plan feature). Example: true.
client_idsarray- Only include time for these client IDs. Use [null] for time with no client. Example: [64123456].
descriptionstring- Only include time entries whose description matches this text. Example: planning.
end_datestring- Last day of the report, YYYY-MM-DD (inclusive). Must be after start_date. Example: 2026-10-31.
enrich_responseboolean- Set to true to return as much detail per row as the export does. Toggl defaults to false. Example: true.
first_row_numberinteger- Row number to start the page from, for pagination. Toggl returns the next value in the X-Next-Row-Number response header of the previous page. Leave empty for the first page. Example: 51.
groupedboolean- Set to true to group similar time entries together. Toggl defaults to false. Example: true.
order_bystring- Sort field: date, user, duration, description or last_update. Toggl defaults to date. Example: duration.one of
dateuserdurationdescriptionlast_update order_dirstring- Sort direction: ASC or DESC. Example: DESC.one of
ASCDESC page_sizeinteger- Rows per page. Toggl defaults to 50. Example: 50.
project_idsarray- Only include time on these project IDs. Use [null] for time with no project. Example: [203456789].
tag_idsarray- Only include time with these tag IDs. Use [null] for time with no tags. Example: [15234567].
task_idsarray- Only include time on these task IDs. Use [null] for time with no task. Example: [98765432].
user_idsarray- Only include time from these user IDs. Get them from the list workspace users tool. Example: [5123456].
toggl_get_organizationGet one Toggl Track organization by ID.Read-onlyGet Organization
Get one Toggl Track organization by ID. Returns the organization id, name, pricing plan name and id, admin and owner flags, user_count, max_workspaces, and trial info. Use this for a known organization's plan and size. Use list_organizations to find organization IDs.
Inputs
organization_idintegerrequired- Numeric ID of the organization. Get it from the list organizations tool, or organization_id on a workspace. Example: 7654321.
toggl_get_projectGet one project in a Toggl Track workspace by ID.Read-onlyGet Project
Get one project in a Toggl Track workspace by ID. Returns the project id, name, client_id, client_name, active and private flags, billable flag, color, dates, estimated and actual hours, rate, and currency. Use this for a known project. Use list_projects to find project IDs and get_project_statistics for its first and last time entries.
Inputs
project_idintegerrequired- Numeric ID of the project. Get it from the list projects tool. Example: 203456789.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
toggl_get_project_statisticsGet the earliest and latest finished time entries tracked on a Toggl Track project.Read-onlyGet Project Statistics
Get the earliest and latest finished time entries tracked on a Toggl Track project. Returns earliest_time_entry and latest_time_entry for the project; running entries are not counted. Use this to see when work on a project started or last happened. Use get_summary_report for totals.
Inputs
project_idintegerrequired- Numeric ID of the project. Get it from the list projects tool. Example: 203456789.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
toggl_get_summary_reportRun a Toggl Track summary report: tracked time aggregated into groups for a workspace and date range, with optional filters.Read-onlyGet Summary Report
Run a Toggl Track summary report: tracked time aggregated into groups for a workspace and date range, with optional filters. Returns the summary report groups with their tracked time; the reference documents no response schema. Use this for totals by project, client or user. Use get_detailed_report for individual entries and get_weekly_report for a day-by-day week view.
Inputs
start_datestringrequired- First day of the report, YYYY-MM-DD (inclusive, evaluated in each user's own time zone). Example: 2026-10-01.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
billableboolean- Only include billable (true) or non-billable (false) time (paid-plan feature). Example: true.
client_idsarray- Only include time for these client IDs. Use [null] for time with no client. Example: [64123456].
descriptionstring- Only include time entries whose description matches this text. Example: planning.
distinguish_ratesboolean- Set to true to split groups by hourly rate. Toggl defaults to false. Example: true.
end_datestring- Last day of the report, YYYY-MM-DD (inclusive). Must be after start_date. Example: 2026-10-31.
include_time_entry_idsboolean- Set to true to include the time entry IDs behind each group. Toggl defaults to false. Example: true.
project_idsarray- Only include time on these project IDs. Use [null] for time with no project. Example: [203456789].
tag_idsarray- Only include time with these tag IDs. Use [null] for time with no tags. Example: [15234567].
task_idsarray- Only include time on these task IDs. Use [null] for time with no task. Example: [98765432].
user_idsarray- Only include time from these user IDs. Get them from the list workspace users tool. Example: [5123456].
toggl_get_taskGet one task in a Toggl Track project by ID.Read-onlyGet Task
Get one task in a Toggl Track project by ID. Returns the task id, name, project_id, active flag, estimated_seconds, tracked_seconds, and assigned user. Use this for a known task. Use list_project_tasks to find task IDs.
Inputs
project_idintegerrequired- Numeric ID of the project. Get it from the list projects tool. Example: 203456789.
task_idintegerrequired- Numeric ID of the task. Get it from the list project tasks or list workspace tasks tool. Example: 98765432.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
toggl_get_time_entryGet one time entry the connected user can access, by ID.Read-onlyGet Time Entry
Get one time entry the connected user can access, by ID. Returns the time entry with id, workspace_id, project_id, task_id, description, start, stop, duration, tags, tag_ids, and billable flag; with meta on, also project, client and task names. Use this for a known entry. Use list_time_entries to browse entries by date.
Inputs
time_entry_idintegerrequired- Numeric ID of the time entry. Get it from the list time entries tool or the response of the create time entry tool. Example: 3456789012.
include_sharingboolean- Set to true to include who each time entry is shared with. Example: true.
metaboolean- Set to true to add related names to each time entry (project name and color, client name, task name, user name). Leave empty for the plain time entry fields. Example: true.
toggl_get_weekly_reportRun a Toggl Track weekly report: tracked time per day over 7-day periods, grouped by users and projects, for a workspace and date range.Read-onlyGet Weekly Report
Run a Toggl Track weekly report: tracked time per day over 7-day periods, grouped by users and projects, for a workspace and date range. Returns the weekly report rows with daily tracked time; the reference documents no response schema. Use this for a day-by-day timesheet view. Use get_summary_report for totals over any range.
Inputs
start_datestringrequired- First day of the report, YYYY-MM-DD (inclusive, evaluated in each user's own time zone). Example: 2026-10-01.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
billableboolean- Only include billable (true) or non-billable (false) time (paid-plan feature). Example: true.
client_idsarray- Only include time for these client IDs. Use [null] for time with no client. Example: [64123456].
descriptionstring- Only include time entries whose description matches this text. Example: planning.
end_datestring- Last day of the report, YYYY-MM-DD (inclusive). Must be after start_date. Example: 2026-10-31.
project_idsarray- Only include time on these project IDs. Use [null] for time with no project. Example: [203456789].
tag_idsarray- Only include time with these tag IDs. Use [null] for time with no tags. Example: [15234567].
task_idsarray- Only include time on these task IDs. Use [null] for time with no task. Example: [98765432].
user_idsarray- Only include time from these user IDs. Get them from the list workspace users tool. Example: [5123456].
toggl_get_workspaceGet one Toggl Track workspace by ID.Read-onlyGet Workspace
Get one Toggl Track workspace by ID. Returns the workspace id, name, organization_id, plan flags, default currency and hourly rate, rounding settings, and admin-only permissions. Use this for the settings of a known workspace. Use list_workspaces to find workspace IDs.
Inputs
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
toggl_list_clientsList clients in a Toggl Track workspace, optionally filtered by status or name.Read-onlyList Clients
List clients in a Toggl Track workspace, optionally filtered by status or name. Returns an array of clients with id, name, notes, archived flag, external_reference, and workspace id (wid). Use this to find client IDs. Use get_client for one client you already know.
Inputs
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
namestring- Return clients whose name contains this text (case-insensitive). Example: acme.
statusstring- Which clients to return: active, archived, or both. Toggl returns only active clients when empty. Example: both.one of
activearchivedboth
toggl_list_organization_usersList users in a Toggl Track organization, with filters for name or email, status, admins, groups and workspaces.Read-onlyList Organization Users
List users in a Toggl Track organization, with filters for name or email, status, admins, groups and workspaces. Returns an array of organization users with id, user_id, name, email, admin and owner flags, inactive flag, joined status, groups, and workspaces. Use this for organization-wide membership. Use list_workspace_users for one workspace.
Inputs
organization_idintegerrequired- Numeric ID of the organization. Get it from the list organizations tool, or organization_id on a workspace. Example: 7654321.
active_statusstring- Comma-separated statuses to include: active, inactive, invited. All statuses when empty. Example: active,invited.
filterstring- Return users whose name or email contains this text. Example: jane.
groupsstring- Comma-separated group IDs; returns only users in these groups. Example: 112233,112234.
only_adminsstring- Set to true to return only admins. Example: true.
pageinteger- Page number. Toggl defaults to 1. Example: 2.
per_pageinteger- Users per page. Toggl defaults to 50. Example: 100.
sort_dirstring- Sort direction by name: asc or desc. Toggl defaults to asc. Example: desc.one of
ascdesc workspacesstring- Comma-separated workspace IDs; returns only users in these workspaces. Example: 1234567,1234568.
toggl_list_organizationsList the Toggl Track organizations the connected user belongs to.Read-onlyList Organizations
List the Toggl Track organizations the connected user belongs to. Returns an array of organizations with id, name, pricing plan, admin and owner flags, user_count, and max_workspaces; empty when the user has none. Use this to find an organization_id. Use get_organization for one organization.
Inputs
This tool takes no inputs.
toggl_list_project_tasksList the tasks in one Toggl Track project.Read-onlyList Project Tasks
List the tasks in one Toggl Track project. Returns an array of tasks with id, name, project_id, active flag, estimated_seconds, tracked_seconds, and assigned user. Use this for one project's tasks. Use list_workspace_tasks to search tasks across the workspace.
Inputs
project_idintegerrequired- Numeric ID of the project. Get it from the list projects tool. Example: 203456789.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
activeboolean- Set to true to return only open tasks. Leave empty or false for all tasks. Example: true.
toggl_list_project_usersList project memberships in a Toggl Track workspace, optionally for specific projects or one user.Read-onlyList Project Users
List project memberships in a Toggl Track workspace, optionally for specific projects or one user. Returns an array of project users with id, project_id, user_id, manager flag, rate, and labor cost. Use this to see who is on which project and to find project user IDs. Use add_project_user to add a member.
Inputs
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
project_idsstring- Comma-separated project IDs to filter by. Example: 203456789,203456790.
user_idstring- Only return memberships for this user ID. Example: 5123456.
with_group_membersboolean- Set to true to include members added through groups. Example: true.
toggl_list_projectsList projects in a Toggl Track workspace, optionally filtered by status, client, name or search text.Read-onlyList Projects
List projects in a Toggl Track workspace, optionally filtered by status, client, name or search text. Returns an array of projects with id, name, client_id, client_name, active, is_private, billable, color, estimated and actual hours, and rate. Use this to find project IDs or browse projects. Use get_project for one project you already know.
Inputs
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
activestring- Filter by status: true for active projects, false for archived ones, both for all. Example: both.one of
truefalseboth billableboolean- Return only billable (true) or non-billable (false) projects. Example: true.
client_idsstring- Comma-separated client IDs to filter by. Example: 64123456,64123457.
namestring- Return projects whose name matches this value. Example: Website Redesign.
only_meboolean- Set to true to return only projects the connected user is assigned to. Example: true.
only_templatesboolean- Set to true to return only project templates. Example: true.
pageinteger- Page number to return, starting at 1. Example: 2.
per_pageinteger- Projects per page, up to 200. Toggl defaults to 151. Example: 50.
project_idsstring- Comma-separated project IDs to return. Example: 203456789,203456790.
searchstring- Return projects whose name contains this text. Example: website.
sinceinteger- Only return projects created, changed or deleted after this UNIX timestamp in seconds. Toggl rejects timestamps older than 3 months. Example: 1791936000.
toggl_list_time_entriesList the connected user's own time entries, optionally limited to a date range or to entries changed since a timestamp.Read-onlyList Time Entries
List the connected user's own time entries, optionally limited to a date range or to entries changed since a timestamp. Returns an array of time entries with id, workspace_id, project_id, task_id, description, start, stop, duration in seconds (negative while running), tags, and billable flag; with meta on, also project, client and task names. Use this for the user's own recent or date-bounded entries (up to 1,000). Use get_detailed_report for other users' time or longer ranges, and get_current_time_entry for the running timer.
Inputs
beforestring- Only return entries that start before this date, as YYYY-MM-DD or an RFC 3339 timestamp. Example: 2026-10-01.
end_datestring- Only return entries that start before this date, as YYYY-MM-DD or an RFC 3339 timestamp. A bare date means midnight, so use 2026-10-31T23:59:59Z to include that whole day. Example: 2026-10-31T23:59:59Z.
include_sharingboolean- Set to true to include who each time entry is shared with. Example: true.
metaboolean- Set to true to add related names to each time entry (project name and color, client name, task name, user name). Leave empty for the plain time entry fields. Example: true.
sinceinteger- Only return entries created, changed or deleted after this UNIX timestamp in seconds; deleted entries are included. Toggl rejects timestamps older than 3 months. Example: 1791936000.
start_datestring- Only return entries that start on or after this date, as YYYY-MM-DD or an RFC 3339 timestamp. Use together with end_date. Example: 2026-10-01.
toggl_list_workspace_tasksList or search tasks across all projects in a Toggl Track workspace, with paging and sorting.Read-onlyList Workspace Tasks
List or search tasks across all projects in a Toggl Track workspace, with paging and sorting. Returns an object with data (an array of tasks with id, name, project_id, active flag, and estimates), page, per_page, sort_field, sort_order, and total_count. Use this to search tasks workspace-wide. Use list_project_tasks for the tasks of one project.
Inputs
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
activestring- Filter by status: true for open tasks, false for done tasks, both for all. Example: both.one of
truefalseboth end_datestring- Latest boundary date, YYYY-MM-DD. Example: 2026-10-31.
pageinteger- Page number to return. Toggl defaults to 1. Example: 2.
per_pageinteger- Tasks per page. Toggl defaults to 50. Example: 100.
pidinteger- Only return tasks in this project ID. Example: 203456789.
searchstring- Return tasks whose name contains this text. Example: homepage.
sinceinteger- Only return tasks created, changed or deleted after this UNIX timestamp in seconds. Toggl rejects timestamps older than 3 months. Example: 1791936000.
sort_fieldstring- Field to sort by: name or created_at. Toggl defaults to name. Example: created_at.one of
namecreated_at sort_orderstring- Sort direction: ASC or DESC. Toggl defaults to ASC. Example: DESC.one of
ASCDESC start_datestring- Earliest boundary date, YYYY-MM-DD. Example: 2026-10-01.
toggl_list_workspace_usersList the users in a Toggl Track workspace.Read-onlyList Workspace Users
List the users in a Toggl Track workspace. Returns an array of users with id, email, fullname, role, admin flag, and active and inactive flags. Use this to find user IDs for reports, tasks and project membership. Use list_organization_users for organization-wide membership.
Inputs
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
exclude_deletedboolean- Set to true to leave out deleted users. Example: true.
toggl_list_workspacesList the Toggl Track workspaces the connected user belongs to.Read-onlyList Workspaces
List the Toggl Track workspaces the connected user belongs to. Returns an array of workspaces with id, name, organization_id, premium and admin flags, default currency and hourly rate, and workspace settings. Use this to find a workspace_id for other tools. Use get_workspace for one workspace you already know.
Inputs
This tool takes no inputs.
toggl_add_project_userAdd a workspace user to a project, optionally as manager or with a project rate.WriteAdd Project User
Add a workspace user to a project, optionally as manager or with a project rate. Returns the new project user with its id, project_id, user_id, manager flag, rate, and labor cost. Use this to give a user access to a private project. Use update_project_user to change an existing membership.
Inputs
project_idintegerrequired- Numeric ID of the project to add the user to. Get it from the list projects tool. Example: 203456789.
user_idintegerrequired- Numeric ID of the user to add. Get it from the list workspace users tool. Example: 5123456.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
labor_costnumber- Labor cost per hour for this user on the project (paid-plan feature). Example: 40.
labor_cost_change_modestring- Which time entries a new labor cost applies to: start-today, override-current or override-all. Example: start-today.one of
start-todayoverride-currentoverride-all managerboolean- Whether the user manages the project. Example: true.
ratenumber- Hourly rate for this user on the project (paid-plan feature). Example: 85.
rate_change_modestring- Which time entries a new rate applies to: start-today, override-current or override-all. Example: start-today.one of
start-todayoverride-currentoverride-all
toggl_archive_clientArchive a client and its projects (paid-plan workspaces only).WriteArchive Client
Archive a client and its projects (paid-plan workspaces only). Returns an array of the IDs of the projects archived along with the client. Use this to hide a client without deleting it. Use restore_client to bring it back.
- Idempotent
Inputs
client_idintegerrequired- Numeric ID of the client. Get it from the list clients tool. Example: 64123456.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
toggl_create_clientCreate a client in a Toggl Track workspace.WriteCreate Client
Create a client in a Toggl Track workspace. Returns the created client with its id, name, notes, archived flag, and external_reference. Use this to add a client before creating projects for it. Use update_client to change an existing one.
Inputs
namestringrequired- Name of the client. Example: Acme Corp.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
external_referencestring- Your own reference for the client, such as an ID from another system. Example: CRM-1042.
notesstring- Free-text notes about the client. Example: Primary contact is Jane Doe.
toggl_create_projectCreate a project in a Toggl Track workspace, optionally linked to a client.WriteCreate Project
Create a project in a Toggl Track workspace, optionally linked to a client. Returns the created project with its id, name, client_id, active and private flags, color, and billing settings. Use this to add a project. Use update_project to change an existing one.
Inputs
namestringrequired- Name of the project. Must be unique within the workspace. Example: Website Redesign.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
activeboolean- Whether the project is active. Set to false to archive it. Example: true.
billableboolean- Whether time on the project is billable by default (paid-plan feature). Example: true.
client_idinteger- Numeric ID of the client the project belongs to. Get it from the list clients tool. Example: 64123456.
colorstring- Project color as a hex code. Example: #0b83d9.
currencystring- Currency code for the project rate (paid-plan feature). Example: USD.
end_datestring- End date of the project timeframe, YYYY-MM-DD. Example: 2026-12-31.
estimated_hoursinteger- Estimated hours for the project (paid-plan feature). Example: 120.
external_referencestring- Your own reference for the project, such as an ID from another system. Example: CRM-4821.
fixed_feenumber- Fixed fee for the project (paid-plan feature). Example: 5000.
is_privateboolean- Whether the project is private (visible only to its members). Example: true.
ratenumber- Hourly rate for the project (paid-plan feature). Example: 95.5.
start_datestring- Start date of the project timeframe, YYYY-MM-DD. Example: 2026-10-01.
toggl_create_tagCreate a tag in a Toggl Track workspace.WriteCreate Tag
Create a tag in a Toggl Track workspace. Returns the created tag data (documented as an array of tags) with id, name, and workspace_id. Use this to add a tag ahead of time. Use create_time_entry with tag names to create tags on the fly.
Inputs
namestringrequired- Name of the tag. Must be unique in the workspace. Example: meeting.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
toggl_create_taskCreate a task in a Toggl Track project (tasks are a paid-plan feature).WriteCreate Task
Create a task in a Toggl Track project (tasks are a paid-plan feature). Returns the created task with its id, name, project_id, active flag, estimated_seconds, and assigned user. Use this to add a task to a project. Use update_task to change or close an existing one.
Inputs
namestringrequired- Name of the task. Example: Design homepage.
project_idintegerrequired- Numeric ID of the project. Get it from the list projects tool. Example: 203456789.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
activeboolean- Whether the task is open. Set to false to mark it done. Example: false.
estimated_secondsinteger- Estimated effort in seconds. Example: 7200.
external_referencestring- Your own reference for the task, such as an issue key. Example: WEB-142.
user_idinteger- Numeric ID of the user to assign the task to. Get it from the list workspace users tool. Example: 5123456.
toggl_create_time_entryCreate a time entry in a Toggl Track workspace, either as a finished entry (start plus duration or stop) or as a running timer (duration -1).WriteCreate Time Entry
Create a time entry in a Toggl Track workspace, either as a finished entry (start plus duration or stop) or as a running timer (duration -1). Returns the created time entry with its id, start, stop, duration, description, project_id, and tags. Use this to log time or start a timer. Use update_time_entry to change an existing entry and stop_time_entry to stop a running one.
Inputs
durationintegerrequired- Duration in seconds. Use a positive number (for example 3600) for a finished entry, or -1 to start a running timer. If you also set stop, it must equal start plus duration. Example: 3600.
startstringrequired- Start time of the time entry in UTC, RFC 3339 format. Example: 2026-10-14T09:00:00Z.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
billableboolean- Whether the entry is billable (a paid-plan feature). Toggl defaults to false. Example: true.
created_withstring- Name of the application creating the entry. Toggl requires it on every new time entry; the tool sends "Scalekit AgentKit" unless you override it. Example: Scalekit AgentKit.default
Scalekit AgentKit descriptionstring- What the time was spent on. Example: Sprint planning meeting.
metaboolean- Set to true to add related names to each time entry (project name and color, client name, task name, user name). Leave empty for the plain time entry fields. Example: true.
project_idinteger- Numeric ID of the project to assign the entry to. Get it from the list projects tool. Example: 203456789.
stopstring- Stop time in UTC, RFC 3339 format. Optional: Toggl derives it from start plus duration, so leave it empty for a running entry. Example: 2026-10-14T10:00:00Z.
tag_idsarray- Numeric IDs of existing tags to apply. Get them from the list tags tool. Example: [15234567].
tagsarray- Tag names to apply. Tags that don't exist yet are created automatically. Example: ["meeting", "billable"].
task_idinteger- Numeric ID of a task within the project. Get it from the list project tasks tool. Example: 98765432.
toggl_restore_clientRestore an archived client, along with all or selected projects.WriteRestore Client
Restore an archived client, along with all or selected projects. Returns the restored client with its id, name, notes, and archived flag. Use this to undo archive_client. Set restore_all_projects or list the projects to restore.
Inputs
client_idintegerrequired- Numeric ID of the client. Get it from the list clients tool. Example: 64123456.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
projectsarray- IDs of the specific projects to restore with the client. Example: [203456789].
restore_all_projectsboolean- Set to true to restore every project archived with the client. Example: true.
toggl_stop_time_entryStop a running time entry at the current time.WriteStop Time Entry
Stop a running time entry at the current time. Returns the stopped time entry with its final stop time and duration in seconds; fails with 409 if it is already stopped. Use this to end a running timer. Use update_time_entry to set a specific stop time. Requires the running entry's id from get_current_time_entry.
Inputs
time_entry_idintegerrequired- Numeric ID of the time entry. Get it from the list time entries tool or the response of the create time entry tool. Example: 3456789012.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
toggl_update_clientUpdate a client's name, notes, or external reference.WriteUpdate Client
Update a client's name, notes, or external reference. Returns the updated client with its id, name, notes, archived flag, and external_reference. Use this to edit a client. Use archive_client or restore_client to change its archived state.
- Idempotent
Inputs
client_idintegerrequired- Numeric ID of the client. Get it from the list clients tool. Example: 64123456.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
external_referencestring- Your own reference for the client, such as an ID from another system. Example: CRM-1042.
namestring- New name for the client. Example: Acme Corporation.
notesstring- Free-text notes about the client. Example: Primary contact is Jane Doe.
toggl_update_projectUpdate a project's name, client, status, privacy, color, dates, estimate, or billing settings.WriteUpdate Project
Update a project's name, client, status, privacy, color, dates, estimate, or billing settings. Returns the updated project with its id, name, client_id, active and private flags, color, and billing settings. Use this to edit or archive a project (set active to false). Use delete_project to remove it.
- Idempotent
Inputs
project_idintegerrequired- Numeric ID of the project. Get it from the list projects tool. Example: 203456789.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
activeboolean- Whether the project is active. Set to false to archive it. Example: true.
billableboolean- Whether time on the project is billable by default (paid-plan feature). Example: true.
client_idinteger- Numeric ID of the client the project belongs to. Get it from the list clients tool. Example: 64123456.
colorstring- Project color as a hex code. Example: #0b83d9.
currencystring- Currency code for the project rate (paid-plan feature). Example: USD.
end_datestring- End date of the project timeframe, YYYY-MM-DD. Example: 2026-12-31.
estimated_hoursinteger- Estimated hours for the project (paid-plan feature). Example: 120.
external_referencestring- Your own reference for the project, such as an ID from another system. Example: CRM-4821.
fixed_feenumber- Fixed fee for the project (paid-plan feature). Example: 5000.
is_privateboolean- Whether the project is private (visible only to its members). Example: true.
namestring- New name for the project. Example: Website Redesign Phase 2.
ratenumber- Hourly rate for the project (paid-plan feature). Example: 95.5.
start_datestring- Start date of the project timeframe, YYYY-MM-DD. Example: 2026-10-01.
toggl_update_project_userUpdate a project membership's manager flag, rate, or labor cost.WriteUpdate Project User
Update a project membership's manager flag, rate, or labor cost. Returns the updated project user with its id, project_id, user_id, manager flag, rate, and labor cost. Use this to change a member's role or rate. Use remove_project_user to take them off the project. Requires a project user id from list_project_users.
- Idempotent
Inputs
project_user_idintegerrequired- Numeric ID of the project user (the membership record linking a user to a project, not the user ID). Get it from the list project users tool. Example: 123456789.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
labor_costnumber- Labor cost per hour for this user on the project (paid-plan feature). Example: 40.
labor_cost_change_modestring- Which time entries a new labor cost applies to: start-today, override-current or override-all. Example: start-today.one of
start-todayoverride-currentoverride-all managerboolean- Whether the user manages the project. Example: true.
ratenumber- Hourly rate for this user on the project (paid-plan feature). Example: 85.
rate_change_modestring- Which time entries a new rate applies to: start-today, override-current or override-all. Example: start-today.one of
start-todayoverride-currentoverride-all
toggl_update_tagRename a tag in a Toggl Track workspace.WriteRename Tag
Rename a tag in a Toggl Track workspace. Returns the updated tag data (documented as an array of tags) with id, name, and workspace_id. Use this to rename a tag everywhere it is used. Use delete_tag to remove it.
- Idempotent
Inputs
namestringrequired- New name for the tag. Example: client-meeting.
tag_idintegerrequired- Numeric ID of the tag. Get it from the list tags tool. Example: 15234567.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
toggl_update_taskUpdate a task's name, status, estimate, assignee, or external reference.WriteUpdate Task
Update a task's name, status, estimate, assignee, or external reference. Returns the updated task with its id, name, project_id, active flag, estimated_seconds, and assigned user. Use this to edit a task or mark it done (set active to false). Use delete_task to remove it.
- Idempotent
Inputs
project_idintegerrequired- Numeric ID of the project. Get it from the list projects tool. Example: 203456789.
task_idintegerrequired- Numeric ID of the task. Get it from the list project tasks or list workspace tasks tool. Example: 98765432.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
activeboolean- Whether the task is open. Set to false to mark it done. Example: false.
estimated_secondsinteger- Estimated effort in seconds. Example: 7200.
external_referencestring- Your own reference for the task, such as an issue key. Example: WEB-142.
namestring- New name for the task. Example: Design homepage v2.
user_idinteger- Numeric ID of the user to assign the task to. Get it from the list workspace users tool. Example: 5123456.
toggl_update_time_entryUpdate a time entry's description, times, project, task, tags, or billable flag.WriteUpdate Time Entry
Update a time entry's description, times, project, task, tags, or billable flag. Returns the updated time entry with its id, start, stop, duration, description, project_id, and tags. Use this to edit an entry. Use stop_time_entry to stop a running timer at the current time.
- Idempotent
Inputs
time_entry_idintegerrequired- Numeric ID of the time entry. Get it from the list time entries tool or the response of the create time entry tool. Example: 3456789012.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
billableboolean- Whether the entry is billable (a paid-plan feature). Toggl defaults to false. Example: true.
descriptionstring- What the time was spent on. Example: Sprint planning meeting.
durationinteger- New duration in seconds. Use a positive number for a finished entry, or -1 for a running timer. If you also set stop, it must equal start plus duration. Example: 3600.
metaboolean- Set to true to add related names to each time entry (project name and color, client name, task name, user name). Leave empty for the plain time entry fields. Example: true.
project_idinteger- Numeric ID of the project to assign the entry to. Get it from the list projects tool. Example: 203456789.
startstring- New start time of the time entry in UTC, RFC 3339 format. Example: 2026-10-14T09:00:00Z.
stopstring- Stop time in UTC, RFC 3339 format. Optional: Toggl derives it from start plus duration, so leave it empty for a running entry. Example: 2026-10-14T10:00:00Z.
tag_actionstring- How to apply tags or tag_ids on update: add appends them to the entry's existing tags, delete removes them. Leave empty to replace the tags. Example: add.one of
adddelete tag_idsarray- Numeric IDs of existing tags to apply. Get them from the list tags tool. Example: [15234567].
tagsarray- Tag names to apply. Tags that don't exist yet are created automatically. Example: ["meeting", "billable"].
task_idinteger- Numeric ID of a task within the project. Get it from the list project tasks tool. Example: 98765432.
toggl_delete_clientDelete a client from a Toggl Track workspace.DestructiveDelete Client
Delete a client from a Toggl Track workspace. Returns only the HTTP status; the response body is empty. Use this to remove a client permanently. Use archive_client to hide it instead.
- Idempotent
Inputs
client_idintegerrequired- Numeric ID of the client. Get it from the list clients tool. Example: 64123456.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
toggl_delete_projectDelete a project and either delete or unassign its time entries.DestructiveDelete Project
Delete a project and either delete or unassign its time entries. Returns only the HTTP status; the response body is empty. Use this to remove a project permanently. Use update_project with active false to archive it instead.
- Idempotent
Inputs
project_idintegerrequired- Numeric ID of the project. Get it from the list projects tool. Example: 203456789.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
teDeletionModestring- What happens to the project's time entries: delete removes them, unassign keeps them without a project. Example: unassign.one of
deleteunassign
toggl_delete_tagDelete a tag from a Toggl Track workspace.DestructiveDelete Tag
Delete a tag from a Toggl Track workspace. Returns only the HTTP status; the response body is empty. Use this to remove a tag. Use update_tag to rename it instead.
- Idempotent
Inputs
tag_idintegerrequired- Numeric ID of the tag. Get it from the list tags tool. Example: 15234567.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
toggl_delete_taskDelete a task from a Toggl Track project.DestructiveDelete Task
Delete a task from a Toggl Track project. Returns only the HTTP status; the response body is empty. Use this to remove a task. Use update_task with active false to mark it done instead.
- Idempotent
Inputs
project_idintegerrequired- Numeric ID of the project. Get it from the list projects tool. Example: 203456789.
task_idintegerrequired- Numeric ID of the task. Get it from the list project tasks or list workspace tasks tool. Example: 98765432.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
toggl_delete_time_entryDelete a time entry permanently.DestructiveDelete Time Entry
Delete a time entry permanently. Returns only the HTTP status; the response body is empty. Use this to remove an entry. Use update_time_entry to correct it instead.
- Idempotent
Inputs
time_entry_idintegerrequired- Numeric ID of the time entry. Get it from the list time entries tool or the response of the create time entry tool. Example: 3456789012.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
toggl_remove_project_userRemove a user from a project.DestructiveRemove Project User
Remove a user from a project. Returns only the HTTP status; the response body is empty. Use this to take a member off a project. Use update_project_user to change their role instead. Requires a project user id from list_project_users.
- Idempotent
Inputs
project_user_idintegerrequired- Numeric ID of the project user (the membership record linking a user to a project, not the user ID). Get it from the list project users tool. Example: 123456789.
workspace_idintegerrequired- Numeric ID of the Toggl Track workspace. Get it from the list workspaces tool, or use default_workspace_id from the get current user tool. Example: 1234567.
No tools match.
