Toggl 2.0

Manage Focus alerts with the following actions: - **create**: Create Alerts. (data: payload*{config*, rule_type*, project_id, recipient_group_ids, recipient_roles, recipient_user_ids}) - **delete**: Delete Alerts. (data: alert_id*) - **get**: Get Alerts. (data: alert_id*) - **list**: List Alerts. (data: rule_type, project_id, scope) - **partial-update**: Partial Update Alerts. (data: alert_id*, payload*{config, recipient_group_ids, recipient_roles, recipient_user_ids, rule_type}) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus attachments with the following actions: - **get-workspace-attachment-storage**: Get Workspace Attachment Storage Attachments. (data: none) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus audit-log with the following actions: - **get-organization**: Get Organization Audit Log. (data: action, custom_field_id, entity_id, entity_type, export, from*, page_number, page_size, project_id, to*, user_id, workspace_id) - **list**: List Audit Log. (data: action, custom_field_id, entity_id, entity_type, export, from*, page_number, page_size, project_id, to*, user_id) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Authenticate this MCP server with Toggl 2.0 via OAuth. Opens browser login and stores credentials locally. Optionally pass workspace_id to pick a specific workspace when multiple are available. When the server runs with TOGGL_API_TOKEN, reports the API-key identity instead and never opens a browser.

Manage Focus capacities with the following actions: - **get-computations**: Compute user or ghost capacity for a date range. (data: end_date*, group*, include_drafts, include_task_estimates, private, start_date*, task_source, team_id, unit, user_id) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus clients with the following actions: - **create**: Create Clients. (data: name*, currency) - **delete**: Delete Clients. (data: client_id*) - **get**: Get Clients. (data: client_id*) - **list**: List Clients. Clients group billable work; projects can reference client_id. Filter projects with projects.list --client-id. (data: name, page, per_page) - **restore**: Restore Clients. (data: client_id*) - **update**: Update Clients. (data: client_id*, payload*{name, currency}) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus custom-fields with the following actions: - **create**: Create Custom Fields. Requires workspace admin (403 otherwise). field_type is one of select, multi_select, text, number, date, checkbox, users; select/multi_select fields can be seeded with options inline. (data: payload*{entity_type*, field_type*, name*, description, options}) - **delete**: Delete Custom Fields. Requires workspace admin. Soft-deletes the field and removes it from entities; this also discards stored values. (data: custom_field_id*) - **get**: Get Custom Fields. (data: custom_field_id*) - **get-allowed-users**: Get Allowed Users Custom Fields. (data: custom_field_id*) - **list**: List Custom Fields. Custom fields are workspace-level definitions attached to project or task entities. Reads work for all members; create/update/delete return 403 for non-admins. Reordering fields is not available through this tool yet. (data: entity_type, order_by, page, per_page) - **options-create**: Options Create Custom Fields. Requires workspace admin. Only valid for select and multi_select fields. (data: custom_field_id*, payload*{name*, color, description}) - **options-delete**: Options Delete Custom Fields. Requires workspace admin. Deleting an option clears it from entities that have it selected. (data: custom_field_id*, option_id*) - **options-list**: Options List Custom Fields. (data: custom_field_id*, name, order_by, page, per_page) - **options-update**: Options Update Custom Fields. Requires workspace admin. Full update (PUT) of the option's name/color/description. (data: custom_field_id*, option_id*, payload*{name*, color, description}) - **replace-custom-field-allowed-users**: Replace Custom Field Allowed Users Custom Fields. (data: custom_field_id*, payload*{user_ids*}) - **update**: Update Custom Fields. Requires workspace admin. Full update (PUT) of name/description only; field_type and entity_type are immutable. Manage options via the options-* actions. (data: custom_field_id*, payload*{name*, description}) - **update-options-order**: Update Options Order Custom Fields. (data: custom_field_id*, payload*{ordered_ids*}) - **update-order**: Update Order Custom Fields. (data: payload*{entity_type*, ordered_ids*}) - **update-user-custom-field-values**: Update User Custom Field Values Custom Fields. (data: payload*, user_id*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus designations with the following actions: - **bulk-create-workspace**: Bulk Create Workspace Designations. (data: payload*{designations*}) - **bulk-delete-workspace**: Bulk Delete Workspace Designations. (data: all_or_none, ids*) - **bulk-update-workspace**: Bulk Update Workspace Designations. (data: payload*{designations*, all_or_none}) - **create-workspace**: Create Workspace Designations. (data: payload*{name*, member_ids}) - **delete-workspace**: Delete Workspace Designations. (data: designation_id*) - **get-workspace-designations**: Get Workspace Designations Designations. (data: designation_id, name, order_by, page, per_page) - **update-workspace**: Update Workspace Designations. (data: designation_id*, payload*{name*}) - **update-workspace-designation-members**: Update Workspace Designation Members Designations. (data: payload*{add, remove}) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus goals with the following actions: - **create**: Create Goals. (data: payload*{...}) - **delete**: Delete Goals. (data: goal_id*) - **get**: Get Goals. (data: goal_id*) - **list**: List Goals. (data: none) - **preview-goal-tracked-time**: Preview Goal Tracked Time Goals. (data: payload*{...}) - **reorder**: Reorder Goals. (data: payload*{goal_ids*}) - **update**: Update Goals. (data: goal_id*, payload*{active, client_ids, comparison, icon, name, project_ids, recurrence, start_date, tag_ids, target_seconds, task_ids, weekdays}) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Clear local MCP authentication state. Removes stored credentials so subsequent tool calls require auth again.

Manage Focus milestones with the following actions: - **create**: Create Milestones. (data: payload*{color*, due_date*, name*, completed_at, project_ids, team_ids}) - **delete**: Delete Milestones. (data: milestone_id*) - **get**: Get Milestones. (data: milestone_id*) - **get-classic**: Get Classic Milestones. (data: due_date_from, due_date_to, order_by, page, per_page, project_id, team_id) - **get-stream**: Get Stream Milestones. (data: due_date_from, due_date_to, order_by, project_id, team_id) - **partial-update**: Partial Update Milestones. (data: milestone_id*, payload*{due_date, name, project_ids, team_ids}) - **restore**: Restore Milestones. (data: milestone_id*) - **update**: Update Milestones. (data: milestone_id*, payload*{color*, due_date*, name*, completed_at, project_ids, team_ids}) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus org-invitations with the following actions: - **list**: List pending invitations for the current user account. (data: none) - **create**: Send organization invitations (uses organization ID from your workspace profile). (data: initiating_product*, invitations*, skip_email*) - **get**: Get an invitation by ID. (data: invitation_id*) - **resend**: Resend an invitation email for an organization user record. (data: organization_user_id*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus org-members with the following actions: - **get**: Get an organization user by organization user ID. (data: organization_user_id*) - **update**: Replace organization user settings (roles, groups, tags, etc.). (data: organization_user_id*, payload*{accounts_role_id*, active*, groups*, name*, tags*, workspaces*}) - **set-active**: Activate or deactivate an organization member. (data: organization_user_id*, status*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus org-time-off-me with the following actions: - **list**: List your time off entries between two dates (YYYY-MM-DD). (data: from*, to*) - **update**: Update your time off entries (JSON array). (data: array payload) - **create**: Create your time off entries (JSON array). (data: array payload) - **delete**: Delete your time off entries by ID. (data: ids*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus org-workspaces with the following actions: - **list**: List workspaces under the active organization. (data: none) - **my-roles**: Get your roles for a workspace (defaults to the CLI active workspace when omitted). (data: workspace_id) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus organization with the following actions: - **create-group**: Create an organization group. (data: payload*{emoji*, name*, organization_users*, workspaces*}) - **delete-group**: Delete an organization group. (data: group_id*) - **get-member-tags**: Get Member Tags Organization. (data: workspace_id*) - **get-my-groups**: List organization groups for the current user. (data: none) - **get-roles**: List organization roles. (data: none) - **get-teams**: List organization teams. (data: active_members_only, filter, group_ids, organization_user_id, page, per_page, query, sort_dir, workspace_id*) - **update-group**: Update an organization group. (data: group_id*, payload*{emoji*, name*, organization_users*, workspaces*}) - **update-group-user-role**: Update Group User Role Organization. (data: group_id*, payload*{organization_user_id*, workspace_id*}) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

List saved credential profiles from ~/.toggl/focus-tools.json. The row where active is true is the MCP active profile (active.mcp). Profiles may be shared with the Toggl CLI.

Delete a profile row from ~/.toggl/focus-tools.json. If it was the MCP active profile, active.mcp moves to another remaining profile when possible. This affects both MCP and shared storage; removing a profile used by the CLI removes it for the CLI too. Destructive: call without confirm_token first to receive confirm_required + confirm_token, then repeat with the same profile_name and confirm_token (same pattern as entity mutations).

Set active.mcp to an existing profile name so subsequent entity calls use that credential row.

Manage Focus projects with the following actions: - **create-project**: Create a project with related data such as members, milestones, rates, and billable rates. Follow the create action's privacy and billable guidance. Project fields go under payload.project. Set rates through payload.billable_rates, not the legacy payload.rates (start_at/end_at). For payload.billable_rates: hourly_rate is in the currency's smallest unit, so it depends on the currency: two-decimal currencies like USD/EUR use cents (5000 = 50.00), zero-decimal ones like JPY/KRW use whole units (5000 = 5000), three-decimal ones like KWD/BHD use thousandths. Reads return the same unit. Omit end_date for an open-ended schedule; when set it must be on or after start_date. (data: payload*{project*, billable_rates, members, milestones, rates}) - **add-project-members**: Add Project Members Projects. (data: payload*{role_id*, group_ids, user_ids}, project_id*) - **archive**: Archive Projects. (data: project_id*) - **attachments-bulk-create**: Attachments Bulk Create Projects. Uploads several local files in one call. names and display_orders are optional parallel arrays; they default to the file basenames and array positions. (data: project_id*, file_paths*, names, display_orders) - **attachments-create**: Attachments Create Projects. Uploads a local file (file_path) as an attachment. The mime type is inferred from the extension and the API rejects disallowed types; uploads are capped at 20 MB. (data: project_id*, file_path*, name, display_order) - **attachments-delete**: Attachments Delete Projects. (data: attachment_id*, project_id*) - **attachments-list**: Attachments List Projects. Lists attachment metadata. Upload files with attachments-create (file_path), download with attachments-view (save_to). (data: order_by, project_id*) - **attachments-update**: Attachments Update Projects. Full update (PUT): both name and display_order are required; the response body is empty, verify via attachments-list. (data: attachment_id*, payload*{display_order*, name*}, project_id*) - **attachments-view**: Attachments View Projects. Downloads the attachment's binary content to a local path (save_to). Refuses to replace an existing file unless overwrite is true. (data: project_id*, attachment_id*, save_to*, overwrite) - **bulk-archive**: Bulk Archive Projects. (data: project_ids*) - **bulk-delete**: Bulk Delete Projects. Deletes all listed project IDs in one HTTP call. (data: ids*) - **bulk-patch**: Bulk Patch Projects. Prefer over many project updates: JSON array of { id: projectId, ...partial fields } matching single-project patch fields. (data: array payload) - **bulk-restore**: Bulk Restore Projects. (data: project_ids*) - **bulk-unarchive**: Bulk Unarchive Projects. (data: project_ids*) - **complete**: Complete Projects. (data: project_id*) - **create**: Create Projects. Required: name. Recommended: color (hex). The API defaults private and billable to false when omitted. Match the Toggl UI on privacy. If the user explicitly asks for a shared or public project, pass private=false; no permissions check is needed, because only private projects require an entitlement. Otherwise call workspace-settings get-user-permissions and pass private=true when permissions includes access_private_projects_tasks_feature. If that permission is absent, pass private=false and tell the user; if the user explicitly required a private project, do not create a shared one. Leave billable unset unless the user explicitly says the work is billable or provides a rate. Associate with a client via client_id. (data: name*, auto_compute_estimates, billable, client_id, color, completion_mode, custom_fields, description, draft, end_date, estimate_source, estimated_mins, fixed_fee{amount*, currency*}, is_template, parent_project_id, pinned, private, rollover_mode, rrule, start_date, tag_ids) - **create-from-template**: Create From Template Projects. (data: payload*{auto_compute_estimates, completion_mode, end_date, estimate_source, name, pinned, rollover_mode, rrule, start_date}, project_id*) - **create-recurring-project-instance**: Create Recurring Project Instance Projects. (data: date*, payload*{billable, estimate_source, private}, project_id*) - **create-template-from**: Create Template From Projects. (data: payload*{auto_compute_estimates, estimate_source, estimated_mins, fixed_fee, name, rrule}, project_id*) - **delete**: Delete Projects. Permanently deletes the project and disassociates its tasks. (data: project_id*) - **duplicate**: Duplicate Projects. (data: payload*{name}, project_id*) - **duplicate-template**: Duplicate Template Projects. (data: payload*{name}, project_id*) - **get**: Get Projects. Fetch a single project with aggregated task counts and time estimates. (data: project_id*) - **get-batch-projects-members**: Get Batch Projects Members Projects. (data: ids*) - **get-members**: Get Members Projects. (data: project_id*) - **get-recurring-project-instance**: Get Recurring Project Instance Projects. (data: date*, project_id*) - **get-recurring-project-instances**: Get Recurring Project Instances Projects. (data: end_date, include_rollover, order_by, page, per_page, project_id*, start_date) - **get-templates**: Get Templates Projects. (data: archived, name, order_by, page, per_page) - **get-with-children**: Get With Children Projects. (data: order_by, page, per_page, project_id*) - **get-with-parents**: Get With Parents Projects. (data: order_by, page, per_page, project_id*) - **groups-get**: Groups Get Projects. (data: archived, assignee_user_id, cf_filter, client_id, completed, creator_id, end_date, group*, include_drafts, include_group_totals, include_recurring_series, include_unassigned, name, only_me, order_by, page, parent_project_id, per_page, private, project_id, project_order_by, projects_per_group, start_date, tag_id, user_id) - **list**: List Projects. Use user_id to filter to projects that include a specific member. Filter by pinned=true for starred projects. (data: name, pinned, user_id, client_id, page, per_page) - **make-project-public**: Make Project Public Projects. (data: project_id*) - **margin-targets-clear**: Margin Targets Clear Projects. (data: project_id*) - **margin-targets-get**: Margin Targets Get Projects. (data: project_id*) - **margin-targets-get-workspace**: Margin Targets Get Workspace Projects. (data: none) - **margin-targets-list**: Margin Targets List Projects. (data: none) - **margin-targets-set**: Margin Targets Set Projects. (data: payload*{target_percent*}, project_id*) - **margin-targets-set-workspace**: Margin Targets Set Workspace Projects. (data: payload*{target_percent*}) - **pin**: Pin Projects. (data: project_id*) - **remove-project-member**: Remove Project Member Projects. (data: payload*{group_id, user_id}, project_id*) - **restore**: Restore Projects. (data: project_id*) - **unarchive**: Unarchive Projects. (data: project_id*) - **uncomplete**: Uncomplete Projects. (data: project_id*) - **unpin**: Unpin Projects. (data: project_id*) - **update**: Update Projects. Partial update — provide project_id and only the fields to change under payload. custom_fields writes values as a map keyed by custom field ID; reads return the same data as custom_field_values[], so the write shape is not the read shape. (data: project_id*, payload*{...}) - **full-update**: Full Update Projects. (data: payload*{...}, project_id*) - **update-member-role**: Update Member Role Projects. (data: payload*{role_id*, group_id, user_id}, project_id*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus public-holidays with the following actions: - **get-by-user-ids**: Get By User Ids Public Holidays. (data: end_date*, start_date*, user_id*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus publicsharedreports with the following actions: - **open-public-shared-report**: Open Public Shared Report Publicsharedreports. (data: token*) - **profitability-public-shared-report**: Profitability Public Shared Report Publicsharedreports. (data: include_dicts, payload*{chart_key}, response_format, token*) - **query-public-shared-report**: Query Public Shared Report Publicsharedreports. (data: include_dicts, payload*{chart_key}, response_format, token*) - **workload-public-shared-report**: Workload Public Shared Report Publicsharedreports. (data: payload*{chart_key}, token*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus rates with the following actions: - **billable-check-project-billable-rate-conflicts**: Billable Check Project Billable Rate Conflicts Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*) - **billable-check-project-user-billable-rate-conflicts**: Billable Check Project User Billable Rate Conflicts Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*, user_id*) - **billable-check-workspace-billable-rate-conflicts**: Billable Check Workspace Billable Rate Conflicts Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}) - **billable-check-workspace-user-billable-rate-conflicts**: Billable Check Workspace User Billable Rate Conflicts Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}, user_id*) - **billable-delete-by-id**: Billable Delete By Id Rates. (data: rate_id*) - **billable-delete-project-billable-rate-range**: Billable Delete Project Billable Rate Range Rates. (data: from*, project_id*, to) - **billable-delete-project-user-billable-rate-range**: Billable Delete Project User Billable Rate Range Rates. (data: from*, project_id*, to, user_id*) - **billable-delete-workspace-billable-rate-range**: Billable Delete Workspace Billable Rate Range Rates. (data: from*, to) - **billable-delete-workspace-user-billable-rate-range**: Billable Delete Workspace User Billable Rate Range Rates. (data: from*, to, user_id*) - **billable-get-all-project-user**: Billable Get All Project User Rates. (data: date, order_by, project_id, user_id) - **billable-get-all-workspace-user**: Billable Get All Workspace User Rates. (data: order_by, user_id) - **billable-get-project**: Billable Get Project Rates. (data: order_by, project_id*) - **billable-get-project-user**: Billable Get Project User Rates. (data: order_by, project_id*, user_id*) - **billable-get-projects**: Billable Get Projects Rates. (data: date*, project_id*) - **billable-get-workspace**: Billable Get Workspace Rates. (data: order_by) - **billable-get-workspace-user**: Billable Get Workspace User Rates. (data: order_by, user_id*) - **billable-upsert-project**: Billable Upsert Project Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*) - **billable-upsert-project-user**: Billable Upsert Project User Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*, user_id*) - **billable-upsert-workspace**: Billable Upsert Workspace Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}) - **billable-upsert-workspace-user**: Billable Upsert Workspace User Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}, user_id*) - **delete-project**: Delete Project Rates. (data: from*, project_id*, to*) - **get-current-project**: Get Current Project Rates. (data: project_id*) - **get-project**: Get Project Rates. (data: order_by, project_id*) - **get-project-rates-summary**: Get Project Rates Summary Rates. (data: order_by, page, rows, search) - **labor-check-project-labor-cost-conflicts**: Labor Check Project Labor Cost Conflicts Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*) - **labor-check-project-user-labor-cost-conflicts**: Labor Check Project User Labor Cost Conflicts Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*, user_id*) - **labor-check-workspace-labor-cost-conflicts**: Labor Check Workspace Labor Cost Conflicts Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}) - **labor-check-workspace-user-labor-cost-conflicts**: Labor Check Workspace User Labor Cost Conflicts Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}, user_id*) - **labor-delete-project-labor-cost-rate-range**: Labor Delete Project Labor Cost Rate Range Rates. (data: from*, project_id*, to) - **labor-delete-project-user-labor-cost-rate-range**: Labor Delete Project User Labor Cost Rate Range Rates. (data: from*, project_id*, to, user_id*) - **labor-delete-rate-by-id**: Labor Delete Rate By Id Rates. (data: rate_id*) - **labor-delete-workspace-labor-cost-rate-range**: Labor Delete Workspace Labor Cost Rate Range Rates. (data: from*, to) - **labor-delete-workspace-user-labor-cost-rate-range**: Labor Delete Workspace User Labor Cost Rate Range Rates. (data: from*, to, user_id*) - **labor-get-all-project-user-labor-cost-rates**: Labor Get All Project User Labor Cost Rates Rates. (data: date, order_by, project_id, user_id) - **labor-get-all-workspace-user-labor-cost-rates**: Labor Get All Workspace User Labor Cost Rates Rates. (data: order_by, user_id) - **labor-get-project-labor-cost-rates**: Labor Get Project Labor Cost Rates Rates. (data: order_by, project_id*) - **labor-get-project-user-labor-cost-rates**: Labor Get Project User Labor Cost Rates Rates. (data: order_by, project_id*, user_id*) - **labor-get-workspace-labor-cost-rates**: Labor Get Workspace Labor Cost Rates Rates. (data: order_by) - **labor-get-workspace-user-labor-cost-rates**: Labor Get Workspace User Labor Cost Rates Rates. (data: order_by, user_id*) - **labor-upsert-project-labor-cost-rate**: Labor Upsert Project Labor Cost Rate Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*) - **labor-upsert-project-user-labor-cost-rate**: Labor Upsert Project User Labor Cost Rate Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*, user_id*) - **labor-upsert-workspace-labor-cost-rate**: Labor Upsert Workspace Labor Cost Rate Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}) - **labor-upsert-workspace-user-labor-cost-rate**: Labor Upsert Workspace User Labor Cost Rate Rates. (data: payload*{currency*, hourly_rate*, start_date*, end_date}, user_id*) Applies to billable-check-project-billable-rate-conflicts, billable-check-project-user-billable-rate-conflicts, billable-check-workspace-billable-rate-conflicts, billable-check-workspace-user-billable-rate-conflicts, billable-upsert-project, billable-upsert-project-user, billable-upsert-workspace, billable-upsert-workspace-user, labor-check-project-labor-cost-conflicts, labor-check-project-user-labor-cost-conflicts, labor-check-workspace-labor-cost-conflicts, labor-check-workspace-user-labor-cost-conflicts, labor-upsert-project-labor-cost-rate, labor-upsert-project-user-labor-cost-rate, labor-upsert-workspace-labor-cost-rate, labor-upsert-workspace-user-labor-cost-rate: hourly_rate is in the currency's smallest unit, so it depends on the currency: two-decimal currencies like USD/EUR use cents (5000 = 50.00), zero-decimal ones like JPY/KRW use whole units (5000 = 5000), three-decimal ones like KWD/BHD use thousandths. Reads return the same unit. Omit end_date for an open-ended schedule; when set it must be on or after start_date. Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus recurring-budget-suggestions with the following actions: - **accept-arecurring-project-budget-suggestion**: Accept Arecurring Project Budget Suggestion Recurring Budget Suggestions. (data: project_id*) - **accept-atemplate-estimate-suggestion**: Accept Atemplate Estimate Suggestion Recurring Budget Suggestions. (data: project_id*) - **dismiss-arecurring-project-budget-suggestion**: Dismiss Arecurring Project Budget Suggestion Recurring Budget Suggestions. (data: project_id*) - **dismiss-atemplate-estimate-suggestion**: Dismiss Atemplate Estimate Suggestion Recurring Budget Suggestions. (data: project_id*) - **get-recurring-project-budget-suggestion**: Get Recurring Project Budget Suggestion Recurring Budget Suggestions. (data: project_id*, target_period_start*) - **get-template-estimate-suggestion**: Get Template Estimate Suggestion Recurring Budget Suggestions. (data: project_id*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus reports with the following actions: - **get-flexq-data**: Get Flexq Data Reports. (data: include_dicts, payload*{...}, response_format, xTogglReportExport) - **get-flexq-dictionary**: Get Flexq Dictionary Reports. (data: payload*) - **get-forecast-availability**: Get Forecast Availability Reports. (data: none) - **get-profitability**: Get Profitability Reports. (data: include_dicts, payload*{...}, response_format, xTogglReportExport) - **get-time-accounting**: Get Time Accounting Reports. (data: payload*{...}) - **get-workload**: Get Workload Reports. (data: payload*{...}, xTogglReportExport) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus reportschedules with the following actions: - **delete-shared-report-schedule**: Delete Shared Report Schedule Reportschedules. (data: id*) - **upsert-saved-view-schedule**: Upsert Saved View Schedule Reportschedules. (data: id*, payload*{cadence*, charts*, time*, day, period, recipient_team_ids, recipient_user_ids, recipient_workspace_ids}) - **upsert-shared-report-schedule**: Upsert Shared Report Schedule Reportschedules. (data: id*, payload*{cadence*, time*, day, recipient_team_ids, recipient_user_ids, recipient_workspace_ids}) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus saved-views with the following actions: - **create**: Create Saved Views. Required: name, type, pinned, and params (the view's filter/layout state as an object, e.g. { project_id, filters }). Project-scoped types (project, project.tasks, project.board, project.timeline) expect the project context inside params. (data: payload*{name*, params*, pinned*, type*, icon_name}) - **delete**: Delete Saved Views. Deletes the authenticated user's saved view; it cannot be restored. (data: id*) - **get**: Get Saved Views. id is the saved view ID (number) from saved-views list. (data: id*) - **list**: List Saved Views. Saved views are per-user, so results belong to the authenticated user. Filter by type (inbox, archive, board, timeline, project, project.tasks, project.board, project.timeline, projects) or by partial name match. pinned=true entries are the user's starred views. (data: name, order_by, type) - **update**: Update Saved Views. The payload requires the full updatable set (name, type, pinned, params), so fetch the view first and resend it with your changes to avoid clobbering params. Toggling pinned is how views are starred/unstarred. (data: id*, payload*{name*, params*, pinned*, type*, icon_name}) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus search with the following actions: - **mentions**: Mentions Search. (data: keyword, per_group) - **search**: Search across Toggl 2.0 entities. (data: keyword*, per_group, assignee_user_id, project_id, task_id, include_drafts, exclude_calendar_events, assignee_team_id, group_by_tags, only_me) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus shared-holidays with the following actions: - **list**: List organization holiday calendar dates for a year (optional ISO country override). (data: year*, country) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus shared-status with the following actions: - **get**: Health check for the Shared Data API. (data: none) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus shared-working-hours with the following actions: - **list**: Get your working hours entries for the active organization. (data: none) - **put**: Replace working hours by ID (JSON array of updates). (data: array payload) - **create**: Create working hour rows (JSON array). (data: array payload) - **delete**: Delete working hour rows by ID. (data: ids*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus sharedreports with the following actions: - **add-shared-report-grants**: Add Shared Report Grants Sharedreports. (data: id*, payload*{grantees*}) - **get-saved-view-shared-report**: Get Saved View Shared Report Sharedreports. (data: id*) - **get-shared-report-dates**: Get Shared Report Dates Sharedreports. (data: id*) - **get-shared-report-for-viewer**: Get Shared Report For Viewer Sharedreports. (data: id*) - **get-shared-reports-shared-by-me**: Get Shared Reports Shared By Me Sharedreports. (data: none) - **get-shared-reports-shared-with-me**: Get Shared Reports Shared With Me Sharedreports. (data: none) - **mint-shared-report-link**: Mint Shared Report Link Sharedreports. (data: id*, payload*{expires_at}) - **revoke-shared-report-grant**: Revoke Shared Report Grant Sharedreports. (data: grant_id*, id*) - **revoke-shared-report-link**: Revoke Shared Report Link Sharedreports. (data: id*) - **rotate-shared-report-link**: Rotate Shared Report Link Sharedreports. (data: id*, payload*{expires_at}) - **set-shared-report-dates-lock**: Set Shared Report Dates Lock Sharedreports. (data: id*, payload*{locked*}) - **share-saved-view**: Share Saved View Sharedreports. (data: id*, payload*{charts*, period, team_id, user_id, workspace_id}) - **share-saved-view-many**: Share Saved View Many Sharedreports. (data: id*, payload*{charts*, grantees*, period}) - **unshare-shared-report**: Unshare Shared Report Sharedreports. (data: id*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus statuses with the following actions: - **create-status**: Create a task status. (data: payload*{emoji*, name*, position*}) - **delete-status**: Delete a task status. (data: status_id*) - **get-status**: List task statuses with generated API filters. (data: status_id*) - **list**: List Statuses. Lists all task status options for the workspace. Use returned status IDs when creating or updating tasks via status_id. Statuses have types: todo, in_progress, done, blocked. (data: page, per_page) - **restore**: Restore Statuses. (data: status_id*) - **update-status**: Update a task status. (data: payload*{emoji*, name*, position*}, status_id*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus subscriptions with the following actions: - **get-current**: Get Current Subscriptions. (data: none) - **get-current-trial**: Get Current Trial Subscriptions. (data: none) - **get-features-upsell**: Get Features Upsell Subscriptions. (data: none) - **get-plans**: Get Plans Subscriptions. (data: none) - **upsert-forced-trial**: Upsert Forced Trial Subscriptions. (data: payload*{plan_workspace_id}) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus tags with the following actions: - **archive**: Archive Tags. (data: tag_id*) - **bulk-archive**: Bulk Archive Tags. (data: payload*{tag_ids*}) - **bulk-create**: Bulk Create Tags. (data: payload*{tags*}) - **bulk-delete**: Bulk Delete Tags. (data: ids*) - **bulk-restore**: Bulk Restore Tags. (data: payload*{tag_ids*}) - **bulk-unarchive**: Bulk Unarchive Tags. (data: payload*{tag_ids*}) - **count-tag-time-entries**: Count Tag Time Entries Tags. (data: ids*, match*) - **create**: Create Tags. Both name and color are required by the API (hex color, e.g. #FF5733). (data: color*, name*) - **delete**: Delete Tags. (data: tag_id*) - **get**: Get Tags. (data: tag_id*) - **list**: List Tags. Workspace tags label tasks and projects. Use tag IDs with tasks (tag_ids) and organization user filters (tag_ids on users.list). (data: name, page, per_page) - **merge**: Merge Tags. (data: payload*{source_ids*, target_id*}) - **restore**: Restore Tags. (data: tag_id*) - **unarchive**: Unarchive Tags. (data: tag_id*) - **update**: Update Tags. (data: tag_id*, payload*{color, name}) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus tasks with the following actions: - **create-task**: Create a task with related data such as subtasks and an initial time entry. For payload.task and each payload.subtasks[] item: Send start_date and end_date together, with end_date on or after start_date; for a single due date, send both as that day. (data: payload*{task*, estimate_allocations, subtasks, time_entry}) - **archive**: Archive Tasks. (data: from_recurring_task_id, task_id*) - **attachments-bulk-create**: Attachments Bulk Create Tasks. Uploads several local files in one call. names and display_orders are optional parallel arrays; they default to the file basenames and array positions. (data: task_id*, file_paths*, names, display_orders) - **attachments-create**: Attachments Create Tasks. Uploads a local file (file_path) as an attachment. The mime type is inferred from the extension and the API rejects disallowed types; uploads are capped at 20 MB. (data: task_id*, file_path*, name, display_order) - **attachments-delete**: Attachments Delete Tasks. (data: attachment_id*, task_id*) - **attachments-list**: Attachments List Tasks. Lists attachment metadata. Upload files with attachments-create (file_path), download with attachments-view (save_to). (data: order_by, task_id*) - **attachments-update**: Attachments Update Tasks. Full update (PUT): both name and display_order are required; the response body is empty, verify via attachments-list. (data: attachment_id*, payload*{display_order*, name*}, task_id*) - **attachments-view**: Attachments View Tasks. Downloads the attachment's binary content to a local path (save_to). Refuses to replace an existing file unless overwrite is true. (data: task_id*, attachment_id*, save_to*, overwrite) - **bulk-archive**: Bulk Archive Tasks. (data: task_ids*) - **bulk-create**: Bulk Create Tasks. (data: tasks*) - **bulk-delete**: Bulk Delete Tasks. Deletes all listed task IDs in one HTTP call. Requires confirm flow like single delete. (data: ids*, outbound_sync) - **bulk-duplicate**: Bulk Duplicate Tasks. (data: cascade_duplicate_children*, task_ids*, private) - **bulk-patch**: Bulk Patch Tasks. Prefer over many single updates: pass a JSON array of { id: taskId, ...partial fields }. Same field names and date guidance as single task update. (data: array payload) - **bulk-restore**: Bulk Restore Tasks. (data: task_ids*) - **bulk-unarchive**: Bulk Unarchive Tasks. (data: task_ids*) - **constraints-list**: Constraints List Tasks. (data: none) - **constraints-upsert**: Constraints Upsert Tasks. (data: payload*{enabled*, required_fields*}) - **create**: Create Tasks. Required: name. Strongly recommended: project_id, status_id, assignee_user_ids. Use start_date/end_date for scheduling as date-only YYYY-MM-DD values; never pass RFC 3339 datetimes. Send start_date and end_date together, with end_date on or after start_date; for a single due date, send both as that day. Set estimated_mins for time estimates. (data: name*, allocation_unit, assignee_user_ids, auto_log_time, billable, color, custom_fields, description, end_date, estimate_type, estimated_mins, notes, parent_task_id, pinned, position, priority, priority_at, private, project_id, rollup_enabled, rrule, start_date, status_id, tag_ids, team_assignee_ids) - **create-recurring-occurrence**: Create Recurring Occurrence Tasks. (data: return_occurrence, task_id*) - **delete**: Delete Tasks. Permanently deletes the task and all its subtasks. Cannot be undone. (data: task_id*) - **estimate-allocations-create**: Estimate Allocations Create Tasks. (data: payload*, task_id*) - **estimate-allocations-delete**: Estimate Allocations Delete Tasks. (data: id, task_id*) - **estimate-allocations-list**: Estimate Allocations List Tasks. (data: task_id*) - **estimate-allocations-update**: Estimate Allocations Update Tasks. (data: payload*, task_id*) - **get**: Get Tasks. Fetch a single task with full detail including subtasks and time estimates. (data: task_id*) - **get-by-external-id**: Get By External Id Tasks. (data: ext_id*, source*) - **get-calendar-events**: Get Calendar Events Tasks. (data: calendar_event_id, date_from, date_to, hidden) - **get-picker-task-children**: Get Picker Task Children Tasks. (data: include_unassigned, only_me, page, parent_task_id*, per_page, project_id, search, without_project) - **get-picker-task-groups**: Get Picker Task Groups Tasks. (data: include_unassigned, only_me, page, per_page, pinned_only, project_id, search, without_project) - **get-recurring-instances**: Get Recurring Instances Tasks. (data: archived, assignee_team_id, assignee_user_id, dates_overlap_end, dates_overlap_start, end_date, include_assignees, include_projected_occurrences, max_recurring_occurrences_after, page, per_page, recurring_occurrences_after, recurring_task_ids, recurring_task_read, start_date, tag_id, team_id) - **get-stream**: Get Stream Tasks. (data: active_by_date, active_project, archived, assignee_team_id, assignee_user_id, cf_filter, client_id, dates_overlap_end, dates_overlap_start, end_date, end_date_from, end_date_to, estimated_mins_max, estimated_mins_min, has_dates, has_time_entries, include_assignees, include_drafts, include_parent_matches, include_project_completed, include_projected_occurrences, is_priority, max_recurring_occurrences_after, name, order_by, parent_task_id, pinned, priority, private, project_id, recurring, recurring_occurrences_after, recurring_task_ids, recurring_task_read, source, start_date, start_date_from, start_date_to, state, status_id, tag_id, team_id, toggl_user_id, with_entries) - **get-with-children**: Get With Children Tasks. (data: archived, assignee_user_id, include_assignees, order_by, page, per_page, source, status_id, tag_id, task_id*, team_id) - **get-with-parents**: Get With Parents Tasks. (data: archived, assignee_user_id, include_assignees, order_by, page, per_page, source, status_id, tag_id, task_id*, team_id) - **groups-get**: Groups Get Tasks. (data: assignee_user_id, cf_filter, client_id, collapse_recurring, creator_id, end_date, end_date_from, end_date_to, exclude_empty, group*, group_id, include_assignees, include_drafts, include_projected_occurrences, include_unassigned, include_unmaterialized, max_recurring_occurrences_after, min_days, name, order_by, page, per_page, priority, private, project_id, recurring_occurrences_after, recurring_task_read, source, start_date, start_date_from, start_date_to, status_id, tag_id, team_id, user_cf_filter, user_tag_id, xTimelineFetchTrigger) - **groups-get-user-task-groups-by-project**: Groups Get User Task Groups By Project Tasks. (data: assignee_user_id, cf_filter, client_id, collapse_recurring, creator_id, end_date, end_date_from, end_date_to, exclude_empty, group_id, include_assignees, include_drafts, include_projected_occurrences, include_unassigned, include_unmaterialized, max_recurring_occurrences_after, min_days, name, priority, private, project_id*, recurring_occurrences_after, recurring_task_read, source, start_date, start_date_from, start_date_to, status_id, tag_id, team_id, user_cf_filter, user_tag_id, xTimelineFetchTrigger) - **groups-get-user-task-groups-by-team**: Groups Get User Task Groups By Team Tasks. (data: assignee_user_id, cf_filter, client_id, collapse_recurring, creator_id, end_date, end_date_from, end_date_to, exclude_empty, group_id, include_assignees, include_drafts, include_projected_occurrences, include_unassigned, include_unmaterialized, max_recurring_occurrences_after, min_days, name, priority, private, project_id, recurring_occurrences_after, recurring_task_read, source, start_date, start_date_from, start_date_to, status_id, tag_id, team_id, user_cf_filter, user_tag_id, xTimelineFetchTrigger) - **groups-update**: Groups Update Tasks. (data: group*, payload*) - **list**: List Tasks. Filter by start_date/end_date (ISO 8601, e.g. '2025-04-27') for date ranges, project_id, status_id, or assignee_user_id. Returns paginated results — use page/per_page for more. Use parent_task_id to list subtasks. Priority values: none, low, medium, high. (data: name, status_id, project_id, tag_id, assignee_user_id, priority, start_date, end_date, parent_task_id, page, per_page) - **restore**: Restore Tasks. (data: task_id*) - **suggestions-get-project-suggestion-for-atask**: Suggestions Get Project Suggestion For Atask Tasks. (data: payload*{task_id*}) - **suggestions-get-project-suggestions-for-multiple-tasks**: Suggestions Get Project Suggestions For Multiple Tasks Tasks. (data: payload*{task_ids*}) - **unarchive**: Unarchive Tasks. (data: task_id*) - **update**: Update Tasks. Partial update — only include fields to change in payload. Provide task_id at top level and the fields to update under payload. custom_fields writes values as a map keyed by custom field ID; reads return the same data as custom_field_values[], so the write shape is not the read shape. Send start_date and end_date together, with end_date on or after start_date; to move one date, resend the task's current other date; if the task has none, or that breaks the order, send the new date as both. (data: task_id*, payload*{...}) - **full-update**: Full Update Tasks. Follow the update action's date guidance. (data: payload*{...}, task_id*) - **update-calendar-range**: Update Calendar Range Tasks. (data: date_from*, date_to*, skip_provider_refresh) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus time-entries with the following actions: - **archive**: Archive Time Entries. (data: time_entry_id*) - **bulk-create**: Bulk Create Time Entries. JSON array of entries with task_id, start, duration, type ('activity'|'break'). One HTTP request for many creates. Datetime fields (start, planned_start, planned_at, tracked_at) must be RFC3339 with a timezone (e.g. 2026-04-01T09:00:00Z or 2026-04-01T11:00:00+02:00), not YYYY-MM-DDTHH:MM. (data: array payload) - **bulk-delete**: Bulk Delete Time Entries. Soft-delete multiple time entries by id in one request. (data: ids*) - **bulk-edit**: Bulk Edit Time Entries. (data: payload*{changes*, ids*}) - **bulk-patch**: Bulk Patch Time Entries. JSON array of { id: timeEntryId, ...partial fields } for bulk partial update. Datetime fields (start, planned_start, planned_at, tracked_at) must be RFC3339 with a timezone, or null to clear. (data: array payload) - **bulk-restore**: Bulk Restore Time Entries. Restore deleted time entries by id in one request. (data: ids*) - **bulk-set-day-duration**: Bulk Set Day Duration Time Entries. (data: payload*) - **constraints-list**: Constraints List Time Entries. (data: none) - **constraints-upsert**: Constraints Upsert Time Entries. (data: payload*{enabled*, required_fields*, disallow_billable_override}) - **create**: Create a completed task time entry. payload.type defaults to 'activity' when omitted. Logs a completed task time entry. payload.type defaults to 'activity' when omitted; pass 'break' explicitly for a break. provide payload.start and payload.duration for completed tracked time. payload.start must be RFC3339 with a timezone (e.g. 2026-04-01T09:00:00Z or 2026-04-01T11:00:00+02:00), not YYYY-MM-DDTHH:MM. (data: from_recurring_task_id, payload*{...}, return_occurrence, task_id*) - **create-taskless**: Create a completed taskless time entry. payload.type defaults to 'activity' when omitted. Logs a completed taskless time entry. payload.type defaults to 'activity' when omitted; pass 'break' explicitly for a break. (data: from_recurring_task_id, payload*{...}, return_occurrence) - **delete**: Delete Time Entries. (data: from_recurring_task_id, return_occurrence, time_entry_id*) - **get**: Get Time Entries. (data: time_entry_id*) - **get-batch**: Get Batch Time Entries. (data: ids*) - **get-stream-time-entries-range**: Get Stream Time Entries Range Time Entries. (data: archived, date_from*, date_to*, expand_calendar_event, include_taskless, order_by, project_completed, project_draft, project_id, status_id, task_id, type) - **get-task-time-entries**: Get Task Time Entries Time Entries. (data: archived, include_subtasks, order_by, page, per_page, task_id*, type) - **groups-get-users**: Groups Get Users Time Entries. (data: end_date*, order_by, page, per_page, start_date*, user_id) - **list**: List Time Entries. Returns tracked time entries in a date range, including taskless entries (tracked on a project with no task). Requires date_from and date_to. Accepts date-only strings (YYYY-MM-DD) or RFC3339 datetimes — date-only is automatically expanded: date_from to T00:00:00Z, date_to to T23:59:59Z. Optional project_id keeps only entries on that project (sent to the API; client also scans up to 50 list pages of 100, then slices page/per_page; not a full workspace scan). If truncated is true, more unfiltered rows exist than were scanned — narrow date_from/date_to. Pass include_taskless:false to hide taskless rows. Includes task and project context. (data: date_from*, date_to*, project_id, task_id, time_block_id, type, include_taskless, page, per_page) - **log-planned-time**: Log Planned Time Time Entries. (data: time_entry_id*) - **partial-update**: Partial Update Time Entries. (data: from_recurring_task_id, payload*{billable, duration, reset_billable_to_default, type}, return_occurrence, time_entry_id*) - **restore**: Restore Time Entries. (data: time_entry_id*) - **set-day-duration**: Set Day Duration Time Entries. (data: payload*{date_from*, date_to*, duration*, discriminant, start_time, task_id}) - **start**: Start Time Entries. type defaults to 'activity' if omitted; pass type:'break' to start a break. Optionally provide task_id, project_id, description, and time_block_id. Optional start must be RFC3339 with a timezone (e.g. 2026-04-01T09:00:00Z or 2026-04-01T11:00:00+02:00). Only one timer can be active at a time — stops the current one if running. (data: type, description, project_id, start, task_id, time_block_id) - **stop**: Stop Time Entries. Stops the currently running timer. No input required. (data: none) - **sync**: Sync Time Entries. (data: client_uuid*, payload*{billable_source*, client_updated_at*, type*, billable}) - **tracking-get-tracked-time-entry**: Tracking Get Tracked Time Entry Time Entries. (data: none) - **tracking-start-tracking-from-description**: Tracking Start Tracking From Description Time Entries. (data: payload*{...}) - **unarchive**: Unarchive Time Entries. (data: time_entry_id*) - **update**: Update Time Entries. (data: from_recurring_task_id, payload*{type*, calendar_event_id, description, duration, planned_at, planned_duration, planned_start, start, tracked_at}, return_occurrence, time_entry_id*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus time-off with the following actions: - **approve-timeoff-entry**: Approve Timeoff Entry Time Off. (data: entry_id*) - **archive-timeoff-category**: Archive Timeoff Category Time Off. (data: category_id*) - **cancel-timeoff-entry**: Cancel Timeoff Entry Time Off. (data: entry_id*) - **create-timeoff-balance-adjustment**: Create Timeoff Balance Adjustment Time Off. (data: payload*{amount*, time_off_category_id*, user_id*, date, note}) - **create-timeoff-category**: Create Timeoff Category Time Off. (data: payload*{allow_negative_balance*, auto_approve_under_days*, default_amount_per_year*, description*, emoji*, max_carry_over_amount*, name*, prorate*, accrual_frequency, allowance_type, carry_over_expiry_months, policy_link}) - **create-timeoff-for-user**: Create Timeoff For User Time Off. (data: payload*, user_id*) - **delete-timeoff-category**: Delete Timeoff Category Time Off. (data: category_id*) - **delete-timeoff-for-user**: Delete Timeoff For User Time Off. (data: payload*, user_id*) - **get-timeoff-absence-report**: Get Timeoff Absence Report Time Off. (data: category_id, end_date*, include_pending, start_date*, team_id, user_id) - **get-timeoff-balance-changes-for-user**: Get Timeoff Balance Changes For User Time Off. (data: category_id*, page, rows, user_id*, year) - **get-timeoff-balances**: Get Timeoff Balances Time Off. (data: category_id, date, user_id) - **get-timeoff-balances-for-user**: Get Timeoff Balances For User Time Off. (data: category_id, date, user_id*) - **get-timeoff-categories**: Get Timeoff Categories Time Off. (data: none) - **get-timeoff-category**: Get Timeoff Category Time Off. (data: category_id*) - **get-timeoff-entries**: Get Timeoff Entries Time Off. (data: category_id, from, page, rows, status, team_id, to, user_id) - **get-timeoff-entry**: Get Timeoff Entry Time Off. (data: entry_id*) - **get-timeoff-for-user**: Get Timeoff For User Time Off. (data: from*, to*, user_id*) - **get-timeoff-timeline**: Get Timeoff Timeline Time Off. (data: category_id, from, status, team_id, to, user_id) - **get-timeoff-whos-out**: Get Timeoff Whos Out Time Off. (data: end_date*, start_date*) - **get-timeoffs-by-user-ids**: Get Timeoffs By User Ids Time Off. (data: end_date*, start_date*, user_id*) - **import-timeoff-balances**: Import Timeoff Balances Time Off. (data: payload*{category_id*, rows*}) - **reject-timeoff-entry**: Reject Timeoff Entry Time Off. (data: entry_id*, payload*{reason*}) - **restore-timeoff-category**: Restore Timeoff Category Time Off. (data: category_id*) - **update-timeoff-category**: Update Timeoff Category Time Off. (data: category_id*, payload*{allow_negative_balance*, auto_approve_under_days*, default_amount_per_year*, description*, emoji*, max_carry_over_amount*, name*, prorate*, carry_over_expiry_months, policy_link}) - **update-timeoff-for-user**: Update Timeoff For User Time Off. (data: payload*, user_id*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus timesheets with the following actions: - **add-timesheet-flag**: Add Timesheet Flag Timesheets. (data: payload*{comment*, time_entry_id*}, setup_id*, start_date*, user_account_id*) - **approve**: Approve Timesheets. (data: setup_id*, start_date*, user_account_id*) - **bulk-approve**: Bulk Approve Timesheets. (data: payload*{keys*}) - **bulk-request-changes**: Bulk Request Changes Timesheets. (data: payload*{keys*, comment}) - **bulk-withdraw**: Bulk Withdraw Timesheets. (data: payload*{keys*}) - **get**: Get Timesheets. (data: approver_user_account_ids, current_layer_approver_user_account_id, date_from*, date_to*, page, per_page, setup_id, statuses, team_ids, user_account_ids) - **get-approvers**: Get Approvers Timesheets. (data: none) - **get-details**: Get Details Timesheets. (data: setup_id*, start_date*, user_account_id*) - **get-flags**: Get Flags Timesheets. (data: setup_id*, start_date*, user_account_id*) - **get-history**: Get History Timesheets. (data: setup_id*, start_date*, user_account_id*) - **get-hours**: Get Hours Timesheets. (data: setup_id*, start_date*, user_account_id*) - **get-status-counts**: Get Status Counts Timesheets. (data: approver_user_account_ids, date_from*, date_to*, setup_id, team_ids, user_account_ids) - **remove-timesheet-flag**: Remove Timesheet Flag Timesheets. (data: flag_id*) - **request-changes**: Request Changes Timesheets. (data: payload*{comment*}, setup_id*, start_date*, user_account_id*) - **resubmit**: Resubmit Timesheets. (data: payload*{comment*}, setup_id*, start_date*, user_account_id*) - **setups-add-timesheet-setup-member**: Setups Add Timesheet Setup Member Timesheets. (data: setup_id*, user_account_id*) - **setups-create**: Setups Create Timesheets. (data: payload*{approvers*, member_user_account_ids*, periodicity*, start_date*, email_reminder_enabled, period_days, reminder_day, reminder_time}) - **setups-delete**: Setups Delete Timesheets. (data: setup_id*) - **setups-delete-member**: Setups Delete Member Timesheets. (data: setup_id*, user_account_id*) - **setups-discontinue**: Setups Discontinue Timesheets. (data: payload*{end_date*}, setup_id*) - **setups-discontinue-timesheet-setup-member**: Setups Discontinue Timesheet Setup Member Timesheets. (data: payload*{end_date}, setup_id*, user_account_id*) - **setups-get**: Setups Get Timesheets. (data: setup_id*) - **setups-get-approvers**: Setups Get Approvers Timesheets. (data: setup_id*) - **setups-get-members**: Setups Get Members Timesheets. (data: include_discontinued, setup_id*) - **setups-list**: Setups List Timesheets. (data: approver_user_account_id, include_discontinued, user_account_id) - **setups-reactivate-timesheet-setup-member**: Setups Reactivate Timesheet Setup Member Timesheets. (data: setup_id*, user_account_id*) - **setups-update**: Setups Update Timesheets. (data: payload*{approvers, email_reminder_enabled, member_user_account_ids, reminder, unset_reminder}, setup_id*) - **submit**: Submit Timesheets. (data: setup_id*, start_date*, user_account_id*) - **withdraw**: Withdraw Timesheets. (data: setup_id*, start_date*, user_account_id*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus track-team-invites with the following actions: - **post**: Post Track Team Invites. (data: payload*{organization_user_ids*}) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus users with the following actions: - **list**: List Users. Lists organization users (members). Use returned IDs for assignee_user_ids on tasks. Invite or provision new users from the Toggl Track/Focus web UI or billing admin — this API lists existing users only. (data: page, per_page, filter, sort_dir, only_admins, include_working_hours, include_rates, workspaces, tag_ids, roles, active_status, groups, pinned_ids, user_account_ids, org_user_ids) - **settings-email-unsubscribe**: Settings Email Unsubscribe Users. (data: token*) - **settings-email-unsubscribe-page**: Settings Email Unsubscribe Page Users. (data: token*) - **settings-list**: Settings List Users. (data: none) - **settings-partial-update**: Settings Partial Update Users. (data: payload*{...}) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus version with the following actions: - **service**: MCP package version plus the Focus API service revision. mcp.package is this published MCP package version (e.g. 1.8.0). focus_api is the Focus API process revision (git SHA / build number) — it does not change when you update the npm MCP package. (data: none) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus work-preparation with the following actions: - **get**: Get Work Preparation. (data: page) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus working-hours with the following actions: - **create-for-user**: Create For User Working Hours. (data: payload*, user_id*) - **delete-for-user**: Delete For User Working Hours. (data: payload*, user_id*) - **get-for-user**: Get For User Working Hours. (data: user_id*) - **replace-working-hours-for-users**: Replace Working Hours For Users Working Hours. (data: payload*{schedule*, user_ids*}) - **update-for-user**: Update For User Working Hours. (data: payload*, user_id*) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Manage Focus workspace with the following actions: - **get-context**: Get Context Workspace. (data: none) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

List workspaces for the active MCP profile. Pass refresh: true to refetch from Accounts when a workspace is missing from cache.

Manage Focus workspace-settings with the following actions: - **workspace-settings-list**: List user workspace settings. (data: none) - **workspace-settings-partial-update**: Update user workspace settings. (data: payload*{has_opened_focus, onboarding_intent, onboarding_invited_user_ids, onboarding_project_id, onboarding_step, onboarding_task_id, onboarding_team_size, work_introduction_dismissed}) - **get-user-permissions**: Get User Permissions Workspace Settings. (data: none) - **get-workspace-currency**: Get Workspace Currency Workspace Settings. (data: none) - **get-workspace-export-branding**: Get Workspace Export Branding Workspace Settings. (data: none) - **get-workspace-watermark**: Get Workspace Watermark Workspace Settings. (data: none) - **list**: List Workspace Settings. (data: none) - **update**: Update Workspace Settings. (data: payload*{default_private, settings}) - **update-workspace-currency**: Update Workspace Currency Workspace Settings. (data: payload*{currency*}) - **update-workspace-watermark**: Update Workspace Watermark Workspace Settings. (data: payload*{show_watermark*}) Pass the action-specific fields under `data` (required fields are marked with *). Mutations require a confirm_token handshake: call without confirm_token first to receive a token, then call again with the token to confirm. Optional dry_run: true validates input and returns { dry_run, operation, input } without calling the API.

Switch the active workspace by updating the stored configuration. The new workspace takes effect on the next tool call. Use workspace-list to see available workspace IDs.