Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Toggl 2.0

NPM · @TOGGLHQ/MCP · 2 COMPONENTS

Toggl 2.0 MCP server for tasks, projects, time entries, and workspace operations.

+15 this week 69 Trust /100

Last scanned (13 hours ago)

Scores higher than 39% of npm servers

Category Productivity and Notes

Trust breakdown (7 categories)

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
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
What we tested

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 →

Changelog

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
Diagnostics

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 →

MCP tools · 58 exposed · ~23,826 tokens

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 →

Tool Tokens
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…

NameTypeReqDescription
actionstringyesOne 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_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: create, delete, get, list, partial-update
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: get-item-archival-status, get-upcoming-archival-groups, keep-upcoming-archival-group
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: get, get-classic, restore
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: get, get-classic, restore
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: get, get-classic, restore
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: get, get-get, restore
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
action–yes–
confirm_tokenstring–Mutation confirmation token from previous call
dataobject––
dry_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: get-organization, list
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

auth ~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.

NameTypeReqDescription
accounts_api_urlstring–Optional accounts API URL override (defaults from ENV or production)
focus_api_urlstring–Optional focus API URL override (defaults from ENV or production)
workspace_id–––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
action–yes–
confirm_tokenstring–Mutation confirmation token from previous call
dataobject––
dry_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: archive, create, delete, get, get-archive-preview, list, restore, unarchive, update
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
action–yes–
confirm_tokenstring–Mutation confirmation token from previous call
dataobject––
dry_runboolean––

No output schema declared.

No examples provided.

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** (…

NameTypeReqDescription
actionstringyesOne 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_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: create-acustom-report, delete-acustom-report, get-acustom-report, get-custom-reports, save-acustom-report
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
action–yes–
confirm_tokenstring–Mutation confirmation token from previous call
dataobject––
dry_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: bulk-create-workspace, bulk-delete-workspace, bulk-update-workspace, create-workspace, delete-workspace, get-workspace-designations, update-workspace, update-workspace-designation-members
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: create, delete, get, list, preview-goal-tracked-time, reorder, update
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

logout ~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 ~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.

NameTypeReqDescription
actionstringyesOne of: create, delete, get, get-classic, get-stream, partial-update, restore, update
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: list, create, get, resend
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: get, update, set-active
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: list, update, create, delete
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: list, my-roles
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne 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_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

profile-list ~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 ~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).

NameTypeReqDescription
confirm_tokenstring–Mutation confirmation token from previous call
profile_namestringyesProfile key as shown by profile-list

No output schema declared.

No examples provided.

profile-switch ~41

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

NameTypeReqDescription
profile_namestringyesProfile key as shown by profile-list

No output schema declared.

No examples provided.

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…

NameTypeReqDescription
actionstringyesOne 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_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
action–yes–
confirm_tokenstring–Mutation confirmation token from previous call
dataobject––
dry_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: open-public-shared-report, profitability-public-shared-report, query-public-shared-report, workload-public-shared-report
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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*…

NameTypeReqDescription
actionstringyesOne 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_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: accept-arecurring-project-budget-suggestion, accept-atemplate-estimate-suggestion, dismiss-arecurring-project-budget-suggestion, dismiss-atemplate-estimate-suggestion, get-recurring-project-b…
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: get-flexq-data, get-flexq-dictionary, get-forecast-availability, get-profitability, get-time-accounting, get-workload
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: delete-shared-report-schedule, upsert-saved-view-schedule, upsert-shared-report-schedule
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: create, delete, get, list, update
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: mentions, search
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
action–yes–
confirm_tokenstring–Mutation confirmation token from previous call
dataobject––
dry_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
action–yes–
confirm_tokenstring–Mutation confirmation token from previous call
dataobject––
dry_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: list, put, create, delete
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne 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_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: create-status, delete-status, get-status, list, restore, update-status
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne of: get-current, get-current-trial, get-features-upsell, get-plans, upsert-forced-trial
confirm_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
actionstringyesOne 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_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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…

NameTypeReqDescription
actionstringyesOne 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_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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…

NameTypeReqDescription
actionstringyesOne 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_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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

NameTypeReqDescription
actionstringyesOne 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_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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…

NameTypeReqDescription
actionstringyesOne 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_tokenstring–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_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
action–yes–
confirm_tokenstring–Mutation confirmation token from previous call
dataobject––
dry_runboolean––

No output schema declared.

No examples provided.

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.

NameTypeReqDescription
action–yes–
confirm_tokenstring–Mutation confirmation token from previous call
dataobject––
dry_runboolean––

No output schema declared.

No examples provided.

Install

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

# add to Claude Code
claude mcp add toggl-toggl-mcp -- npx -y @togglhq/mcp
Common questions

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.