Toggl 2.0
NPM · @TOGGLHQ/MCP · 2 COMPONENTS
Toggl 2.0 MCP server for tasks, projects, time entries, and workspace operations.
Available components
Last scanned (13 hours ago)
Scores higher than 39% of npm servers
Category Productivity and Notes
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security95
- No malware found by supply-chain analysis.Pass
- CVE check failed: a known medium-severity CVE affects @opentelemetry/core 2.6.1, reached via @sentry/node > @opentelemetry/instrumentation-http > @opentelemetry/core. A fixed version is available. View diagnostics → Fail
- No install/post-install scripts declared.Pass
- 5 of 76 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency6
- Repository check failed: no source repository is declared. See how to fix → View diagnostics → Fail
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: the license (UNLICENSED) isn't a recognized OSI-approved license. See how to fix → Fail
- Actively maintained (last published 0 days ago).Pass
- Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified
Schema Quality & AI Usability47
- AI-judged instruction clarity (good).Pass
- Context-footprint check failed: tool/resource definitions use about 27189 tokens (~468/item across 58 items; 58 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage88
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 63% of tool parameters carry a description.Partial
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- All 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
- An AI judge read all 59 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
Checks we ran (15)
- Malware scan
- Known CVEs
- Install scripts
- Dependency health
- Source repository
- Provenance
- License
- Maintenance
- Schema quality
- Stability
- Tool coverage
- Injection markers
- Destructive annotations
- Judged manipulation
- MCP protocol
Checks we could not complete (1)
These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.
- Security disclosure in Provenance & TransparencySecurity-disclosure policy not yet verified: we couldn't inspect the source repository.
Does not apply to this package (2)
- Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
- Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
The score does not measure everything. What the score does not measure →
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 21 Nov 26 +24
- Known CVEs: unverified → fail ▼ security
- Malware scan: unverified → pass ▲ security
- Dependency health: unverified → 0.98 ▲ functional
- Package version: 1.13.352 → 1.13.354 functional
- Package version: 1.13.352 → 1.13.353 functional
- 20 Nov 26 −24
- Malware scan: pass → unverified ▼ security
- Stability: pass → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Known CVEs: fail → unverified ▼ security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Dependency health: 0.98 → unverified ▼ functional
- Package version: 1.13.332 → 1.13.352 functional
- Package version: 1.13.332 → 1.13.351 functional
- Package version: 1.13.332 → 1.13.348 functional
- Package version: 1.13.332 → 1.13.346 functional
- Package version: 1.13.332 → 1.13.342 functional
- Package version: 1.13.332 → 1.13.340 functional
- Package version: 1.13.332 → 1.13.339 functional
- Package version: 1.13.332 → 1.13.334 functional
- Package version: 1.13.332 → 1.13.333 functional
- 19 Nov 26 +24
- Known CVEs: unverified → fail ▼ security
- Stability: pass → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Malware scan: unverified → pass ▲ security
- Tool coverage: 100 → unverified ▼ functional
- Capabilities: pass → unverified ▼ functional
- Dependency health: unverified → 0.98 ▲ functional
- Package version: 1.13.311 → 1.13.332 functional
- Package version: 1.13.311 → 1.13.331 functional
- Package version: 1.13.311 → 1.13.330 functional
- Package version: 1.13.311 → 1.13.329 functional
- Package version: 1.13.311 → 1.13.328 functional
- Package version: 1.13.311 → 1.13.327 functional
- Package version: 1.13.311 → 1.13.325 functional
- Package version: 1.13.311 → 1.13.322 functional
- Package version: 1.13.311 → 1.13.321 functional
- Package version: 1.11.218 → 1.13.320 functional
- Package version: 1.13.311 → 1.13.319 functional
- Package version: 1.13.311 → 1.13.317 functional
- Package version: 1.13.311 → 1.13.316 functional
- Package version: 1.13.311 → 1.13.314 functional
- Package version: 1.13.311 → 1.13.313 functional
- Package version: 1.13.311 → 1.13.312 functional
- 18 Nov 26 −9
- Known CVEs: fail → unverified ▼ security
- Malware scan: unverified → pass ▲ security
- Dependency health: 0.98 → unverified ▼ functional
- Package version: 1.13.294 → 1.13.311 functional
- Package version: 1.13.294 → 1.13.310 functional
- Package version: 1.13.294 → 1.13.309 functional
- Package version: 1.13.294 → 1.13.306 functional
- Package version: 1.13.294 → 1.13.305 functional
- Package version: 1.13.294 → 1.13.304 functional
- Package version: 1.13.294 → 1.13.302 functional
- Package version: 1.13.294 → 1.13.301 functional
- Package version: 1.13.294 → 1.13.300 functional
- Package version: 1.13.294 → 1.13.299 functional
- Package version: 1.13.294 → 1.13.298 functional
- Package version: 1.13.294 → 1.13.297 functional
- Package version: 1.13.294 → 1.13.296 functional
- 17 Nov 26 −6
- Known CVEs: unverified → fail ▼ security
- Malware scan: pass → unverified ▼ security
- Dependency health: unverified → 0.98 ▲ functional
- Package version: 1.13.293 → 1.13.294 functional
- 16 Nov 26 +6
- Tool safety: pass → unverified ▼ security
- Stability: pass → unverified ▼ security
- Known CVEs: fail → unverified ▼ security
- Malware scan: unverified → pass ▲ security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Dependency health: 0.98 → unverified ▼ functional
- Package version: 1.13.283 → 1.13.293 functional
- Package version: 1.13.283 → 1.13.292 functional
- Package version: 1.13.283 → 1.13.291 functional
- Package version: 1.13.283 → 1.13.289 functional
- Package version: 1.13.283 → 1.13.286 functional
- Package version: 1.11.218 → 1.13.285 functional
- Package version: 1.13.283 → 1.13.284 functional
- 15 Nov 26 0
- Malware scan: unverified → pass ▲ security
- Package version: 1.13.281 → 1.13.283 functional
- 14 Nov 26 +9
- CVE-2026-128080 affects this package: medium ▼ security
- Known CVEs: unverified → fail ▼ security
- Malware scan: unverified → pass ▲ security
- Dependency health: unverified → 0.98 ▲ functional
- Package version: 1.13.280 → 1.13.281 functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 21 Nov 2026 · Analysed npm/@togglhq/mcp@1.13.354
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | npm |
Background: How many MCP packages publish verified provenance →
Vulnerabilities 4 findings
| ID | CVE | Severity | Vector | Fix available |
|---|---|---|---|---|
| GHSA-8988-4f7v-96qf | CVE-2026-54285 | medium | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:U/C:N/I:N/A:L | yes |
| GHSA-3v2p-hm54-8qcq | CVE-2026-128080 | medium | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:C/C:L/I:N/A:N | yes |
| GHSA-qqmp-wf37-98f9 | CVE-2026-104872 | medium | CVSS:3.1/AV:N/AC:L/PR:N/UI:N/S:C/C:L/I:N/A:N | yes |
| GHSA-g3hv-75wg-m249 | CVE-2026-118764 | medium | yes |
Background: What a vulnerability scan can and cannot prove →
Dependencies 76 packages
| Packages resolved | 76 |
|---|---|
| Stale | 5 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
ai Ai ~870
Manage 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-project-hints** (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-outcomes** (data: payload*{app_version*, drafts*, os*}) - **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-consent** (data: none) - **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: c…
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: accept-ai-change, apply-ai-change, attach-ai-turn, connect-ai-source, day-rebuild-decide, day-rebuild-group, day-rebuild-judge, day-rebuild-name, day-rebuild-project-hints, day-rebuild-projec… |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
alerts Alerts ~249
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: create, delete, get, list, partial-update |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
archival Archival ~221
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: get-item-archival-status, get-upcoming-archival-groups, keep-upcoming-archival-group |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
archived-clients Archived-clients ~199
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: get, get-classic, restore |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
archived-projects Archived-projects ~202
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: get, get-classic, restore |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
archived-tasks Archived-tasks ~202
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: get, get-classic, restore |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
archived-time-entries Archived-time-entries ~211
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: get, get-get, restore |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
attachments Attachments ~129
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | – | yes | – |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | object | – | – |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
audit-log Audit-log ~231
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: get-organization, list |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
auth Authenticate MCP ~113
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.
| Name | Type | Req | Description |
|---|---|---|---|
| accounts_api_url | string | – | Optional accounts API URL override (defaults from ENV or production) |
| focus_api_url | string | – | Optional focus API URL override (defaults from ENV or production) |
| workspace_id | – | – | – |
No output schema declared.
No examples provided.
capacities Capacities ~166
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | – | yes | – |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | object | – | – |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
clients Clients ~317
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: archive, create, delete, get, get-archive-preview, list, restore, unarchive, update |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
currencies Currencies ~124
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | – | yes | – |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | object | – | – |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
custom-fields Custom-fields ~694
Manage 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** (…
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: bulk-patch-user-custom-field-values, create, delete, get, get-allowed-users, list, options-create, options-delete, options-list, options-update, replace-custom-field-allowed-users, replace-cu… |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
customreports Customreports ~245
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: create-acustom-report, delete-acustom-report, get-acustom-report, get-custom-reports, save-acustom-report |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
deep-links Deep-links ~248
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | – | yes | – |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | object | – | – |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
designations Designations ~362
Manage 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, member_user_id, name, order_by, page, per_page, project_id, project_member_user_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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: bulk-create-workspace, bulk-delete-workspace, bulk-update-workspace, create-workspace, delete-workspace, get-workspace-designations, update-workspace, update-workspace-designation-members |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
goals Goals ~279
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: create, delete, get, list, preview-goal-tracked-time, reorder, update |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
logout Logout MCP ~24
Clear local MCP authentication state. Removes stored credentials so subsequent tool calls require auth again.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
milestones Milestones ~332
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: create, delete, get, get-classic, get-stream, partial-update, restore, update |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
org-invitations Org-invitations ~246
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: list, create, get, resend |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
org-members Org-members ~240
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: get, update, set-active |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
org-time-off-me Org-time-off-me ~241
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: list, update, create, delete |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
org-workspaces Org-workspaces ~201
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: list, my-roles |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
organization Organization ~415
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: create-group, create-workspace-invitations, delete-group, get-member-tags, get-my-groups, get-roles, get-teams, update-group, update-group-user-role, update-user-active-status |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
profile-list List MCP profiles ~47
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.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
profile-remove Remove saved profile ~124
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).
| Name | Type | Req | Description |
|---|---|---|---|
| confirm_token | string | – | Mutation confirmation token from previous call |
| profile_name | string | yes | Profile key as shown by profile-list |
No output schema declared.
No examples provided.
profile-switch Switch MCP profile ~41
Set active.mcp to an existing profile name so subsequent entity calls use that credential row.
| Name | Type | Req | Description |
|---|---|---|---|
| profile_name | string | yes | Profile key as shown by profile-list |
No output schema declared.
No examples provided.
projects Projects ~2,130
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** (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 unl…
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: create-project, add-project-members, archive, attachments-bulk-create, attachments-create, attachments-delete, attachments-list, attachments-update, attachments-view, bulk-archive, bulk-delet… |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
public-holidays Public-holidays ~139
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | – | yes | – |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | object | – | – |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
publicsharedreports Publicsharedreports ~258
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: open-public-shared-report, profitability-public-shared-report, query-public-shared-report, workload-public-shared-report |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
rates Rates ~3,054
Manage 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-project-billable-rate-conflicts** (data: payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*) - **billable-check-project-designation-member-billable-rate-conflicts** (data: designation_id*, payload*{currency*, hourly_rate*, start_date*, end_date}, project_id*, user_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-project-billable-rate-range** (data: from*, project_id*, to) - **billable-delete-project-designation-member-billable-rate-range** (data: designation_id*, from*, project_id*, to, user_id*) - **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-designation-member** (data: date, order_by, project_id, user_id) - **billable-get-all-project-user** (data: date, order_by, project_id, user_id) - **billable-get-all-workspace-designation*…
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: billable-bulk-check-workspace-user-billable-rate-conflicts, billable-bulk-upsert-workspace-user, billable-check-project-billable-rate-conflicts, billable-check-project-designation-member-bill… |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
recurring-budget-suggestions Recurring-budget-suggestions ~304
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: accept-arecurring-project-budget-suggestion, accept-atemplate-estimate-suggestion, dismiss-arecurring-project-budget-suggestion, dismiss-atemplate-estimate-suggestion, get-recurring-project-b… |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
reports Reports ~293
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: get-flexq-data, get-flexq-dictionary, get-forecast-availability, get-profitability, get-time-accounting, get-workload |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
reportschedules Reportschedules ~261
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: delete-shared-report-schedule, upsert-saved-view-schedule, upsert-shared-report-schedule |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
saved-views Saved-views ~423
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: create, delete, get, list, update |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
search Search ~214
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: mentions, search |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
shared-holidays Shared-holidays ~145
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | – | yes | – |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | object | – | – |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
shared-status Shared-status ~135
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | – | yes | – |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | object | – | – |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
shared-working-hours Shared-working-hours ~234
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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: list, put, create, delete |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
sharedreports Sharedreports ~592
Manage 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-report-management** (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}) - **rename-shared-report** (data: id*, payload*{name*}) - **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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: add-shared-report-grants, get-member-owned-shared-reports, get-saved-view-shared-report, get-shared-report-dates, get-shared-report-for-viewer, get-shared-report-management, get-shared-report… |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
statuses Statuses ~307
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**: 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: create-status, delete-status, get-status, list, restore, update-status |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
subscriptions Subscriptions ~234
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: get-current, get-current-trial, get-features-upsell, get-plans, upsert-forced-trial |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
tags Tags ~434
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: archive, bulk-archive, bulk-create, bulk-delete, bulk-restore, bulk-unarchive, count-tag-time-entries, create, delete, get, list, merge, restore, unarchive, update |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
tasks Tasks ~2,366
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** (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 sin…
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: create-task, archive, attachments-bulk-create, attachments-create, attachments-delete, attachments-list, attachments-update, attachments-view, bulk-archive, bulk-create, bulk-delete, bulk-dup… |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
time-entries Time-entries ~1,484
Manage 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…
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: archive, bulk-create, bulk-delete, bulk-edit, bulk-patch, bulk-restore, bulk-set-day-duration, constraints-list, constraints-upsert, create, create-taskless, delete, get, get-batch, get-organ… |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
time-off Time-off ~846
Manage 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-…
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: approve-timeoff-entry, archive-timeoff-category, cancel-timeoff-entry, create-timeoff-balance-adjustment, create-timeoff-category, create-timeoff-for-user, delete-timeoff-category, delete-tim… |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
timesheets Timesheets ~1,104
Manage 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, window_anchor) - **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, window_anchor) - **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-discontinu…
| Name | Type | Req | Description |
|---|---|---|---|
| action | string | yes | One of: add-timesheet-flag, approve, bulk-approve, bulk-request-changes, bulk-submit, bulk-withdraw, get, get-approvers, get-details, get-flags, get-history, get-hours, get-status-counts, remove-time… |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | – | – | Action-specific payload. See each action's parameters in this tool's description; pass dry_run: true to validate it without calling the API. |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
track-team-invites Track-team-invites ~138
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | – | yes | – |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | object | – | – |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
usage-signals Usage-signals ~128
Manage 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.
| Name | Type | Req | Description |
|---|---|---|---|
| action | – | yes | – |
| confirm_token | string | – | Mutation confirmation token from previous call |
| data | object | – | – |
| dry_run | boolean | – | – |
No output schema declared.
No examples provided.
How do I install the Toggl 2.0 MCP server?
Toggl 2.0 runs locally as an npm package, launched with npx -y @togglhq/mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · @togglhq/mcp
claude mcp add toggl-toggl-mcp -- npx -y @togglhq/mcp
What is the Toggl 2.0 MCP server?
Toggl 2.0 is an MCP server listed in the public MCP registry as io.github.toggl/toggl-mcp. Toggl 2.0 MCP server for tasks, projects, time entries, and workspace operations. This page covers its npm package (@togglhq/mcp).
Is the Toggl 2.0 MCP server safe to use?
Toggl 2.0 scores 69 out of 100 on VerifyMCP. We recorded 4 known advisories against it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the Toggl 2.0 MCP server expose?
Toggl 2.0 exposes 58 tools: workspace-list, workspace-switch, profile-list, profile-switch, profile-remove, and 53 more. Their descriptions and schemas cost roughly 23,826 tokens of context every time the server is loaded.
Is the Toggl 2.0 MCP server still maintained?
Toggl 2.0 is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the Toggl 2.0 MCP server under?
Toggl 2.0 declares the UNLICENSED licence, which is not on the OSI-approved list. Read the terms before using it at work, and note this covers the source only, not the cost of any service it calls.
What did VerifyMCP test on the Toggl 2.0 MCP server?
VerifyMCP ran 15 checks on Toggl 2.0, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about Toggl 2.0: Security disclosure. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.