All servers / Productivity / Toggl MCP server
Toggl MCP server
Toggl 2.0 MCP server for Claude Code, Claude Desktop, and other MCP clients.
Tested by ConnectATDScore 87 out of 100. Tested 2026-11-18 on package version 1.13.311. Package: @togglhq/mcp
Score breakdown
| Runs | 18 / 20 | |
|---|---|---|
| Tool descriptions | 17 / 20 | |
| Package safety | 16 / 20 | |
| Maintenance | 20 / 20 | |
| Adoption | 16 / 20 |
What we saw
- Starts and answers the MCP handshake: yes (10.7 seconds including download)
- Tools offered: 58
- Last published: 2026-11-18
- Weekly downloads (npm): 25,473
- License: UNLICENSED · Direct dependencies: 2
Want this server set up for your team?
ConnectATD builds AI automation and wires up MCP servers like this one. Tell us what you are trying to do.
Talk to ConnectATDTools and how they are described
Agents choose tools from these descriptions. Under each name you can see how many of its parameters are explained.
workspace-list0 of 1 parameter describedList workspaces for the active MCP profile. Pass refresh: true to refetch from Accounts when a workspace is missing from cache.
workspace-switch0 of 1 parameter describedSwitch 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.
profile-listno parametersList 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.
profile-switch1 of 1 parameter describedSet active.mcp to an existing profile name so subsequent entity calls use that credential row.
profile-remove2 of 2 parameters describedDelete 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).
auth2 of 3 parameters describedAuthenticate 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.
logoutno parametersClear local MCP authentication state. Removes stored credentials so subsequent tool calls require auth again.
ai3 of 4 parameters describedManage Focus ai with the following actions: - **accept-ai-change** (data: conversation_id*, message_id*, product, view_id*) - **apply-ai-change** (data: conversation_id*, message_id*, product, view_id*) - **attach-ai-turn** (data: after, conversation_id*, lastEventID, product) - **connect-ai-source** (data: payload*{redirect_uri*}, source_id*) - **day-rebuild-decide** (data: payload*{evidence*, same_for}) - **day-rebuild-group** (data: payload*{evidence*}) - **day-rebuild-judge** (data: payload*{context*, run_id*, summary*, tools*, final, turns}) - **day-rebuild-name** (data: payload*{evidence*}) - **day-rebuild-projects** (data: payload*{evidence*}) - **day-rebuild-read-connected** (data: payload*{now*, service*, since*, tools*, final, preferred_tools, turns}) - **day-rebuild-save-review** (data: payload*{app_version*, day*, day_review*, drafts*, masked_spans*, os*, rounds*, run_id*, sources*, tracked_minutes*, trigger*}) - **discard-ai-change** (data: conversation_id*, message_id*, product, view_id*) - **disconnect-ai-source** (data: source_id*) - **finish-ai-source** (data: payload*{code*, state*}, source_id*) - **get-conversations** (data: before, limit, product, search) - **get-messages** (data: conversation_id*, limit, product) - **get-sources** (data: none) - **get-usage** (data: none) - **next-ai-actions** (data: conversation_id*, message_id*, product) - **record-ai-message-event** (data: conversation_id*, message_id*, payload*{kind*, at, href, step, view_id}, product) - **remove-ai-attachment** (data: attachment_id*, conversation_id*) - **run-ai-view** (data: payload*{input*, tool*}, product) - **search** (data: q*) - **send-ai-message** (data: conversation_id*, payload*{text*, app_version, attachment_ids, page_context, platform, suggestion_key, tagged}, product) - **stop-ai-turn** (data: conversation_id*, product) - **undo-ai-change** (data: conversation_id*, message_id*, product, view_id*) - **upload-ai-attachment** (data: conversation_id*, file*) 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.
alerts3 of 4 parameters describedManage Focus alerts with the following actions: - **create** (data: payload*{config*, rule_type*, project_id, recipient_group_ids, recipient_roles, recipient_user_ids}) - **delete** (data: alert_id*) - **get** (data: alert_id*) - **list** (data: rule_type, project_id, scope) - **partial-update** (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.
archival3 of 4 parameters describedManage Focus archival with the following actions: - **get-item-archival-status** (data: entity_id*, entity_kind*) - **get-upcoming-archival-groups** (data: page, per_page) - **keep-upcoming-archival-group** (data: group_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.
archived-clients3 of 4 parameters describedManage Focus archived-clients with the following actions: - **get** (data: client_id*) - **get-classic** (data: name, page, per_page) - **restore** (data: client_id*, payload*{request_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.
archived-projects3 of 4 parameters describedManage Focus archived-projects with the following actions: - **get** (data: project_id*) - **get-classic** (data: client_id, name, page, per_page) - **restore** (data: payload*{request_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.
archived-tasks3 of 4 parameters describedManage Focus archived-tasks with the following actions: - **get** (data: task_id*) - **get-classic** (data: name, page, per_page, project_id) - **restore** (data: payload*{request_id*}, task_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.
archived-time-entries3 of 4 parameters describedManage Focus archived-time-entries with the following actions: - **get** (data: date_from*, date_to*, page, per_page, project_id, task_id) - **get-get** (data: time_entry_id*) - **restore** (data: payload*{request_id*}, 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.
attachments1 of 4 parameters describedManage Focus attachments with the following actions: - **get-workspace-attachment-storage** (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.
audit-log3 of 4 parameters describedManage Focus audit-log with the following actions: - **get-organization** (data: action, custom_field_id, entity_id, entity_type, export, from*, page_number, page_size, project_id, to*, user_id, workspace_id) - **list** (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.
capacities1 of 4 parameters describedManage 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.
clients3 of 4 parameters describedManage Focus clients with the following actions: - **archive** (data: client_id*, payload*{project_count*}) - **create** (data: name*, address, contact_email, currency, internal_reference) - **delete** (data: client_id*) - **get** (data: client_id*) - **get-archive-preview** (data: client_id*) - **list**: Clients group billable work; projects can reference client_id. Filter projects with projects.list --client-id. (data: name, page, per_page) - **restore** (data: client_id*) - **unarchive** (data: client_id*) - **update** (data: client_id*, payload*{name, address, contact_email, currency, internal_reference}) 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.
projects3 of 4 parameters describedManage 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** (data: payload*{role_id*, group_ids, user_ids}, project_id*) - **archive** (data: project_id*) - **attachments-bulk-create**: 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**: 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** (data: attachment_id*, project_id*) - **attachments-list**: Lists attachment metadata. Upload files with attachments-create (file_path), download with attachments-view (save_to). (data: order_by, project_id*) - **attachments-update**: 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**: 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** (data: project_ids*) - **bulk-delete**: Deletes all listed project IDs in one HTTP call. (data: ids*) - **bulk-patch**: Prefer over many project updates: JSON array of { id: projectId, ...partial fields } matching single-project patch fields. (data: array payload) - **bulk-restore** (data: project_ids*) - **bulk-unarchive** (data: project_ids*) - **complete** (data: project_id*) - **create**: 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, auto_start_on, 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** (data: payload*{auto_compute_estimates, completion_mode, end_date, estimate_source, name, pinned, rollover_mode, rrule, start_date}, project_id*) - **create-recurring-project-instance** (data: date*, payload*{billable, estimate_source, private}, project_id*) - **create-template-from** (data: payload*{auto_compute_estimates, estimate_source, estimated_mins, fixed_fee, name, rrule}, project_id*) - **delete**: Permanently deletes the project and disassociat…
tasks3 of 4 parameters describedManage 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** (data: from_recurring_task_id, scope, task_id*) - **attachments-bulk-create**: 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**: 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** (data: attachment_id*, task_id*) - **attachments-list**: Lists attachment metadata. Upload files with attachments-create (file_path), download with attachments-view (save_to). (data: order_by, task_id*) - **attachments-update**: 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**: 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** (data: task_ids*) - **bulk-create** (data: tasks*) - **bulk-delete**: Deletes all listed task IDs in one HTTP call. Requires confirm flow like single delete. (data: ids*, outbound_sync) - **bulk-duplicate** (data: cascade_duplicate_children*, task_ids*, private) - **bulk-patch**: 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** (data: task_ids*) - **bulk-unarchive** (data: task_ids*) - **constraints-list** (data: none) - **constraints-upsert** (data: payload*{enabled*, required_fields*}) - **create**: 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** (data: return_occurrence, task_id*) - **delete**: Permanently deletes the task and all its subtasks. Cannot be undone. (data: task_id*) - **estimate-allocations-create** (data: payload*, task_id*) - **estimate-allocations-delete** (data: id, task_id*) - **estimate-allocations-list** (data: task_id*) - **estimate-allocations-update** (data: payload*, task_id*) - **get**: Fetch a single task with full detail including subtasks and time estimates. (data: task_id*) - **get-by-external-id** (data: ext_id*, source*) - **get-calendar-events** (data: calendar_event_id, date_from, date_to, hidden) - **get-delete-impact** (data: from_recurring_task_id, ids*) - **get-picker-task-children** (data: include_unassigned, only_me, page, parent_task_id*, per_page, project_id, search, unified_search, without_project) - **get-picker-task-groups** (data: include_unassigned, occurrence_window_date, occurrence_window_days, only_me, page, per_page, pinned_only, project_id, search, unified_search, without_project) - **get-recurring-instances** (data: archived, assignee_team_id, assignee…
currencies1 of 4 parameters describedManage Focus currencies with the following actions: - **list** (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.
custom-fields3 of 4 parameters describedManage Focus custom-fields with the following actions: - **bulk-patch-user-custom-field-values** (data: payload*{user_ids*}) - **create**: 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, integration_ext_id, integration_source, options}) - **delete**: Requires workspace admin. Soft-deletes the field and removes it from entities; this also discards stored values. (data: custom_field_id*) - **get** (data: custom_field_id*) - **get-allowed-users** (data: custom_field_id*) - **list**: 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**: Requires workspace admin. Only valid for select and multi_select fields. (data: custom_field_id*, payload*{name*, color, description}) - **options-delete**: Requires workspace admin. Deleting an option clears it from entities that have it selected. (data: custom_field_id*, option_id*) - **options-list** (data: custom_field_id*, name, order_by, page, per_page) - **options-update**: 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** (data: custom_field_id*, payload*{user_ids*}) - **replace-custom-field-options** (data: custom_field_id*, payload*{options*}) - **update**: 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** (data: custom_field_id*, payload*{ordered_ids*}) - **update-order** (data: payload*{entity_type*, ordered_ids*}) - **update-user-custom-field-values** (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.
customreports3 of 4 parameters describedManage Focus customreports with the following actions: - **create-acustom-report** (data: payload*{name*, params*}) - **delete-acustom-report** (data: id*) - **get-acustom-report** (data: id*) - **get-custom-reports** (data: none) - **save-acustom-report** (data: id*, payload*{name*, params*}) 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.
designations3 of 4 parameters describedManage Focus designations with the following actions: - **bulk-create-workspace** (data: payload*{designations*}) - **bulk-delete-workspace** (data: all_or_none, ids*) - **bulk-update-workspace** (data: payload*{designations*, all_or_none}) - **create-workspace** (data: payload*{name*, member_ids}) - **delete-workspace** (data: designation_id*) - **get-workspace-designations** (data: designation_id, has_members, has_project_trait, has_role_in_products, include_members, include_project_designation_members, name, order_by, page, per_page, project_id) - **update-workspace** (data: designation_id*, payload*{name*}) - **update-workspace-designation-members** (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.
goals3 of 4 parameters describedManage Focus goals with the following actions: - **create** (data: payload*{...}) - **delete** (data: goal_id*) - **get** (data: goal_id*) - **list** (data: none) - **preview-goal-tracked-time** (data: payload*{...}) - **reorder** (data: payload*{goal_ids*}) - **update** (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.
milestones3 of 4 parameters describedManage Focus milestones with the following actions: - **create** (data: payload*{color*, due_date*, name*, completed_at, project_ids, team_ids}) - **delete** (data: milestone_id*) - **get** (data: milestone_id*) - **get-classic** (data: due_date_from, due_date_to, order_by, page, per_page, project_id, team_id) - **get-stream** (data: due_date_from, due_date_to, order_by, project_id, team_id) - **partial-update** (data: milestone_id*, payload*{color, due_date, name, project_ids, team_ids}) - **restore** (data: milestone_id*) - **update** (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.
organization3 of 4 parameters describedManage Focus organization with the following actions: - **create-group**: Create an organization group. (data: payload*{name*, emoji, organization_users, workspaces}) - **create-workspace-invitations** (data: payload*{emails*, focus_role_id}) - **delete-group**: Delete an organization group. (data: group_id*) - **get-member-tags** (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, has_designations, organization_user_id, page, per_page, query, sort_dir, workspace_id*) - **update-group**: Update an organization group. (data: group_id*, payload*{name*, emoji, organization_users, workspaces}) - **update-group-user-role** (data: group_id*, payload*{organization_user_id*, workspace_id*}) - **update-user-active-status** (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.
public-holidays1 of 4 parameters describedManage Focus public-holidays with the following actions: - **get-by-user-ids** (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.
publicsharedreports3 of 4 parameters describedManage Focus publicsharedreports with the following actions: - **open-public-shared-report** (data: token*) - **profitability-public-shared-report** (data: include_dicts, payload*{chart_key}, response_format, token*) - **query-public-shared-report** (data: include_dicts, payload*{chart_key}, response_format, token*) - **workload-public-shared-report** (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.
rates3 of 4 parameters describedManage Focus rates with the following actions: - **billable-bulk-check-workspace-user-billable-rate-conflicts** (data: payload*{currency*, hourly_rate*, start_date*, user_ids*, end_date}) - **billable-bulk-upsert-workspace-user** (data: payload*{currency*, hourly_rate*, on_conflict*, start_date*, user_ids*, end_date}) - **billable-check-designation-member-billable-rate-conflicts** (data: designation_id*, payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*, user_id*) - **billable-check-project-billable-rate-conflicts** (data: payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*) - **billable-check-project-user-billable-rate-conflicts** (data: payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*, user_id*) - **billable-check-workspace-billable-rate-conflicts** (data: payload*{currency*, hourly_rate*, start_date*, end_date}) - **billable-check-workspace-designation-billable-rate-conflicts** (data: designation_id*, payload*{currency*, hourly_rate*, start_date*, end_date}) - **billable-check-workspace-user-billable-rate-conflicts** (data: payload*{currency*, hourly_rate*, start_date*, end_date}, user_id*) - **billable-delete-by-id** (data: rate_id*) - **billable-delete-designation-member-billable-rate-range** (data: designation_id*, from*, project_id*, to, user_id*) - **billable-delete-project-billable-rate-range** (data: from*, project_id*, to) - **billable-delete-project-user-billable-rate-range** (data: from*, project_id*, to, user_id*) - **billable-delete-workspace-billable-rate-range** (data: from*, to) - **billable-delete-workspace-designation-billable-rate-range** (data: designation_id*, from*, to) - **billable-delete-workspace-user-billable-rate-range** (data: from*, to, user_id*) - **billable-get-all-project-user** (data: date, order_by, project_id, user_id) - **billable-get-all-workspace-designation** (data: designation_id, order_by) - **billable-get-all-workspace-user** (data: date, order_by, user_id) - **billable-get-designation-member** (data: designation_id*, order_by, project_id*, user_id*) - **billable-get-designation-members** (data: date*, project_id*) - **billable-get-project** (data: order_by, project_id*) - **billable-get-project-user** (data: order_by, project_id*, user_id*) - **billable-get-projects** (data: date*, project_id*) - **billable-get-workspace** (data: order_by) - **billable-get-workspace-designation** (data: designation_id*, order_by) - **billable-get-workspace-user** (data: order_by, user_id*) - **billable-upsert-designation-member** (data: designation_id*, payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*, user_id*) - **billable-upsert-project** (data: payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*) - **billable-upsert-project-user** (data: payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*, user_id*) - **billable-upsert-workspace** (data: payload*{currency*, hourly_rate*, start_date*, end_date}) - **billable-upsert-workspace-designation** (data: designation_id*, payload*{currency*, hourly_rate*, start_date*, end_date}) - **billable-upsert-workspace-user** (data: payload*{currency*, hourly_rate*, start_date*, end_date}, user_id*) - **delete-project** (data: from*, project_id*, to*) - **get-current-project** (data: project_id*) - **get-project** (data: order_by, project_id*) - **get-project-rates-summary** (data: order_by, page, rows, search) - **labor-bulk-check-workspace-user-labor-cost-rate-conflicts** (data: payload*{currency*, hourly_rate*, start_date*, user_ids*, end_date}) - **labor-bulk-upsert-workspace-user-labor-cost-rate** (data: payload*{currency*, hourly_rate*, on_conflict*, start_date*, user_ids*, end_date}) - **labor-check-designation-member-labor-cost-conflicts** (data: designation_id*, payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*, user_id*) - **labor-check-project-labor-cost-conflicts** (data: payload*{currency*, hourly_rate*, start_date*, en…
recurring-budget-suggestions3 of 4 parameters describedManage Focus recurring-budget-suggestions with the following actions: - **accept-arecurring-project-budget-suggestion** (data: project_id*) - **accept-atemplate-estimate-suggestion** (data: project_id*) - **dismiss-arecurring-project-budget-suggestion** (data: project_id*) - **dismiss-atemplate-estimate-suggestion** (data: project_id*) - **get-recurring-project-budget-suggestion** (data: project_id*, target_period_start*) - **get-template-estimate-suggestion** (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.
reports3 of 4 parameters describedManage Focus reports with the following actions: - **get-flexq-data** (data: include_dicts, payload*{...}, response_format, xTogglReportExport) - **get-flexq-dictionary** (data: payload*) - **get-forecast-availability** (data: none) - **get-profitability** (data: include_dicts, payload*{...}, response_format, xTogglReportExport) - **get-time-accounting** (data: payload*{...}) - **get-workload** (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.
reportschedules3 of 4 parameters describedManage Focus reportschedules with the following actions: - **delete-shared-report-schedule** (data: id*) - **upsert-saved-view-schedule** (data: id*, payload*{cadence*, charts*, time*, day, period, recipient_team_ids, recipient_user_ids, recipient_workspace_ids}) - **upsert-shared-report-schedule** (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.
saved-views3 of 4 parameters describedManage Focus saved-views with the following actions: - **create**: 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*, type*, icon_name, pinned}) - **delete**: Deletes the authenticated user's saved view; it cannot be restored. (data: id*) - **get**: id is the saved view ID (number) from saved-views list. (data: id*) - **list**: 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**: 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.
search3 of 4 parameters describedManage Focus search with the following actions: - **mentions** (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.
sharedreports3 of 4 parameters describedManage Focus sharedreports with the following actions: - **add-shared-report-grants** (data: id*, payload*{grantees*}) - **get-member-owned-shared-reports** (data: user_id*) - **get-saved-view-shared-report** (data: id*) - **get-shared-report-dates** (data: id*) - **get-shared-report-for-viewer** (data: id*) - **get-shared-reports-shared-by-me** (data: none) - **get-shared-reports-shared-with-me** (data: none) - **mint-shared-report-link** (data: id*, payload*{expires_at}) - **revoke-shared-report-grant** (data: grant_id*, id*) - **revoke-shared-report-link** (data: id*) - **rotate-shared-report-link** (data: id*, payload*{expires_at}) - **set-shared-report-dates-lock** (data: id*, payload*{locked*}) - **share-saved-view** (data: id*, payload*{charts*, period, team_id, user_id, workspace_id}) - **share-saved-view-many** (data: id*, payload*{charts*, grantees*, period}) - **take-over-member-shared-reports** (data: user_id*) - **unshare-shared-report** (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.
statuses3 of 4 parameters describedManage 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**: 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** (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.
subscriptions3 of 4 parameters describedManage Focus subscriptions with the following actions: - **get-current** (data: none) - **get-current-trial** (data: none) - **get-features-upsell** (data: none) - **get-plans** (data: none) - **upsert-forced-trial** (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.
tags3 of 4 parameters describedManage Focus tags with the following actions: - **archive** (data: tag_id*) - **bulk-archive** (data: payload*{tag_ids*}) - **bulk-create** (data: payload*{tags*}) - **bulk-delete** (data: ids*) - **bulk-restore** (data: payload*{tag_ids*}) - **bulk-unarchive** (data: payload*{tag_ids*}) - **count-tag-time-entries** (data: ids*, match*) - **create**: Both name and color are required by the API (hex color, e.g. #FF5733). (data: color*, name*) - **delete** (data: tag_id*) - **get** (data: tag_id*) - **list**: 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** (data: payload*{source_ids*, target_id*}) - **restore** (data: tag_id*) - **unarchive** (data: tag_id*) - **update** (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.
time-entries3 of 4 parameters describedManage Focus time-entries with the following actions: - **archive** (data: time_entry_id*) - **bulk-create**: 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**: Soft-delete multiple time entries by id in one request. (data: ids*) - **bulk-edit** (data: payload*{changes*, ids*}) - **bulk-patch**: 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**: Restore deleted time entries by id in one request. (data: ids*) - **bulk-set-day-duration** (data: payload*) - **constraints-list** (data: none) - **constraints-upsert** (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** (data: from_recurring_task_id, return_occurrence, time_entry_id*) - **get** (data: time_entry_id*) - **get-batch** (data: ids*) - **get-organization-time-entry-presence** (data: none) - **get-stream-time-entries-range** (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** (data: archived, include_subtasks, order_by, page, per_page, task_id*, type) - **groups-get-users** (data: end_date*, order_by, page, per_page, start_date*, user_id) - **list**: 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** (data: payload*, time_entry_id*) - **partial-update** (data: from_recurring_task_id, payload*{billable, duration, reset_billable_to_default, type}, return_occurrence, time_entry_id*) - **restore** (data: time_entry_id*) - **set-day-duration** (data: payload*{date_from*, date_to*, duration*, discriminant, start_time, task_id}) - **start**: 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**: Stops the currently runnin…
time-off3 of 4 parameters describedManage Focus time-off with the following actions: - **approve-timeoff-entry** (data: entry_id*) - **archive-timeoff-category** (data: category_id*) - **cancel-timeoff-entry** (data: entry_id*) - **create-timeoff-balance-adjustment** (data: payload*{amount*, time_off_category_id*, user_id*, date, note}) - **create-timeoff-category** (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** (data: payload*, user_id*) - **delete-timeoff-category** (data: category_id*) - **delete-timeoff-for-user** (data: payload*, user_id*) - **get-timeoff-absence-report** (data: category_id, end_date*, include_pending, start_date*, team_id, user_id) - **get-timeoff-balance-changes-for-user** (data: category_id*, page, rows, user_id*, year) - **get-timeoff-balances** (data: category_id, date, user_id) - **get-timeoff-balances-for-user** (data: category_id, date, user_id*) - **get-timeoff-categories** (data: none) - **get-timeoff-category** (data: category_id*) - **get-timeoff-entries** (data: category_id, from, page, rows, status, team_id, to, user_id) - **get-timeoff-entry** (data: entry_id*) - **get-timeoff-for-user** (data: from*, to*, user_id*) - **get-timeoff-timeline** (data: category_id, from, status, team_id, to, user_id) - **get-timeoff-whos-out** (data: end_date*, start_date*) - **get-timeoffs-by-user-ids** (data: end_date*, start_date*, user_id*) - **import-timeoff-balances** (data: payload*{category_id*, rows*}) - **reject-timeoff-entry** (data: entry_id*, payload*{reason*}) - **restore-timeoff-category** (data: category_id*) - **update-timeoff-category** (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** (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.
timesheets3 of 4 parameters describedManage Focus timesheets with the following actions: - **add-timesheet-flag** (data: payload*{comment*, time_entry_id*}, setup_id*, start_date*, user_account_id*) - **approve** (data: setup_id*, start_date*, user_account_id*) - **bulk-approve** (data: payload*{keys*}) - **bulk-request-changes** (data: payload*{keys*, comment}) - **bulk-submit** (data: payload*{keys*}) - **bulk-withdraw** (data: payload*{keys*}) - **get** (data: approver_user_account_ids, current_layer_approver_user_account_id, date_from*, date_to*, member_status, page, per_page, setup_id, statuses, team_ids, user_account_ids) - **get-approvers** (data: none) - **get-details** (data: setup_id*, start_date*, user_account_id*) - **get-flags** (data: setup_id*, start_date*, user_account_id*) - **get-history** (data: setup_id*, start_date*, user_account_id*) - **get-hours** (data: setup_id*, start_date*, user_account_id*) - **get-status-counts** (data: approver_user_account_ids, date_from*, date_to*, member_status, setup_id, team_ids, user_account_ids) - **remove-timesheet-flag** (data: flag_id*) - **request-changes** (data: payload*{comment*}, setup_id*, start_date*, user_account_id*) - **resubmit** (data: payload*{comment*}, setup_id*, start_date*, user_account_id*) - **setups-add-timesheet-setup-member** (data: payload*{started_at}, setup_id*, user_account_id*) - **setups-bulk-discontinue-timesheet-setup-members** (data: payload*{items*}) - **setups-bulk-reactivate-timesheet-setup-members** (data: payload*{items*}) - **setups-bulk-update-timesheet-setup-reminder** (data: payload*{items*}) - **setups-cancel-timesheet-setup-member-move** (data: setup_id*, user_account_id*) - **setups-create** (data: payload*{approvers*, member_user_account_ids*, periodicity*, start_date*, email_reminder_enabled, member_starts, period_days, reminder_day, reminder_time}) - **setups-delete** (data: setup_id*) - **setups-delete-member** (data: setup_id*, user_account_id*) - **setups-discontinue** (data: payload*{end_date*}, setup_id*) - **setups-discontinue-timesheet-setup-member** (data: payload*{end_date}, setup_id*, user_account_id*) - **setups-get** (data: setup_id*) - **setups-get-approvers** (data: setup_id*) - **setups-get-members** (data: include_discontinued, setup_id*) - **setups-list** (data: approver_user_account_id, include_discontinued, user_account_id) - **setups-move-timesheet-setup-member** (data: payload*{started_at*, target_setup_id*}, setup_id*, user_account_id*) - **setups-reactivate-timesheet-setup-member** (data: setup_id*, user_account_id*) - **setups-update** (data: payload*{approvers, email_reminder_enabled, member_user_account_ids, reminder, start_date, unset_reminder}, setup_id*) - **submit** (data: setup_id*, start_date*, user_account_id*) - **withdraw** (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.
track-team-invites1 of 4 parameters describedManage Focus track-team-invites with the following actions: - **post** (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.
usage-signals1 of 4 parameters describedManage Focus usage-signals with the following actions: - **list** (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.
users3 of 4 parameters describedManage Focus users with the following actions: - **list**: 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** (data: token*) - **settings-email-unsubscribe-page** (data: token*) - **settings-get-desktop** (data: none) - **settings-get-landing-workspace** (data: first_launch) - **settings-list** (data: none) - **settings-partial-update** (data: payload*{...}) - **settings-record-workspace-opened** (data: none) - **settings-update-desktop** (data: payload*{desktop_autotracker_enabled, desktop_autotracker_focus_duration_enabled, desktop_autotracker_focus_duration_secs, desktop_autotracker_rules, desktop_autotracker_stop_on_no_match}) 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.
workspace-settings3 of 4 parameters describedManage 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** (data: none) - **get-workspace-currency** (data: none) - **get-workspace-export-branding** (data: none) - **get-workspace-watermark** (data: none) - **list** (data: none) - **update** (data: payload*{archival_period_months, default_private, settings}) - **update-workspace-currency** (data: payload*{currency*}) - **update-workspace-watermark** (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.
version1 of 4 parameters describedManage 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.
work-preparation1 of 4 parameters describedManage Focus work-preparation with the following actions: - **get** (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.
working-hours3 of 4 parameters describedManage Focus working-hours with the following actions: - **create-for-user** (data: payload*, user_id*) - **delete-for-user** (data: payload*, user_id*) - **get-for-user** (data: user_id*) - **replace-working-hours-for-users** (data: payload*{schedule*, user_ids*}) - **update-for-user** (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.
workspace1 of 4 parameters describedManage Focus workspace with the following actions: - **get-context** (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.
org-invitations3 of 4 parameters describedManage 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.
org-members3 of 4 parameters describedManage 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.
org-workspaces3 of 4 parameters describedManage 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.
shared-status1 of 4 parameters describedManage 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.
shared-holidays1 of 4 parameters describedManage 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.
shared-working-hours3 of 4 parameters describedManage 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.
org-time-off-me3 of 4 parameters describedManage 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.
deep-links1 of 4 parameters describedManage Focus deep-links with the following actions: - **get**: Build Toggl 2.0 web URLs (and Track URLs where IDs map) for a task, project, time entry, calendar day, report or member. Read-only; makes no API calls. member id is the organization user ID. time_entry needs task_id to open the entry itself. report_type defaults to summary; set period (preset) or from/to (YYYY-MM-DD) for a date range. track.url is null with a note when the IDs do not map to Track. (data: entity*, id, task_id, project_id, date, report_type, period, from, to, tab) 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.
Tested in a sandbox with an empty environment: no API keys, a throwaway folder, nothing from a real account. A passing test shows the server runs and responds. It is not a security audit.