Log inSubmit server
MCP Toggl logo

MCP Toggl

Connects AI clients to Toggl Track for time reports, timer control, workspace lookups, and desktop activity timelines.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install MCP Toggl

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "mcp-toggl": {
      "command": "npx",
      "args": [
        "-y",
        "@verygoodplugins/mcp-toggl@latest"
      ],
      "env": {
        "TOGGL_API_KEY": "YOUR_VALUE_HERE",
        "TOGGL_API_TOKEN": "YOUR_VALUE_HERE",
        "TOGGL_TOKEN": "YOUR_VALUE_HERE",
        "TOGGL_DEFAULT_WORKSPACE_ID": "YOUR_VALUE_HERE",
        "TOGGL_CACHE_TTL": "YOUR_VALUE_HERE",
        "TOGGL_CACHE_SIZE": "YOUR_VALUE_HERE",
        "TOGGL_BATCH_SIZE": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

Automated check passed— started and listed 16 tools correctly (3d ago).

Overview

The mcp-toggl MCP server connects MCP-compatible clients to Toggl Track through its API. It provides reporting, hydrated time entries, timer controls, workspace and project lookups, cache management, and optional desktop activity timelines. Use it when an agent needs to inspect tracked time, start or stop timers, compare periods, or summarize work. Node.js 20.19.0 or newer, a Toggl account, and an API token are required.

Use cases

  • Generate daily or weekly time reports
  • Start and stop Toggl timers from an MCP client
  • Compare tracked time across projects or workspaces
  • Inspect desktop activity around a tracked entry
  • Summarize cached Toggl data for a work recap

Key features

  • Hydrated Toggl time entries
  • Daily, weekly, project, and workspace reports
  • Timer start, stop, and status controls
  • Desktop activity timeline summaries
  • Cache warming, statistics, and clearing
  • Timeline event redaction and summary-only output

Tools16

What MCP Toggl lets your agent do. Expand a tool for its parameters.

Verified live~1.5k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

What it can do

From the 16 tools this server returned when we ran it; 16 declare their own safety hints.

Makes network requests · 14Read-only tools · 16
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age414 days
Maintainers2

Observed 2026-10-25 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 7d ago via OSV.dev · @verygoodplugins/mcp-toggl@latest (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars36Stargazers on the source repository.
npm downloads799Package downloads in the last 30 days.
Last commit6d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed16Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How MCP Toggl works

What mcp-toggl MCP server does

The mcp-toggl MCP server exposes Toggl Track data and actions to an MCP client. It is intended for time tracking, reporting, and work-pattern analysis within the Workplace & Productivity category. Reports can include project, workspace, client, tag, and running-timer context, reducing the need for separate lookups before an agent summarizes results.

The server supports daily and weekly reports, date-range queries, project and workspace totals, current timer inspection, timer creation and stopping, and workspace or project discovery. It can also read Toggl Track Desktop activity when timeline synchronization is enabled.

How it works

The server communicates with Toggl Track through the Toggl API and returns structured data for the connected MCP client to interpret or render. Reporting tools support shortcuts such as today, yesterday, week, lastWeek, month, and lastMonth where applicable. Weekly reports can also use a week offset, such as -1 for the previous week.

Entity lookups use an in-memory cache for workspaces, projects, clients, tasks, and tags. Cache tools allow an agent to preload data, inspect hit and miss statistics, or clear entries after Toggl entities change. The server also returns structured information for workspace-resolution and rate-limit errors when available.

Setup and configuration

Install and run the package with Node.js ^20.19.0 or >=22.12.0. A Toggl Track account and API token are required. For Claude Desktop, configure the server with npx -y @verygoodplugins/mcp-toggl@latest, then provide TOGGL_API_KEY in the environment. TOGGL_DEFAULT_WORKSPACE_ID is optional; it avoids ambiguity when an account has multiple workspaces. With one accessible workspace, the server can resolve it automatically.

The server also accepts TOGGL_API_TOKEN and TOGGL_TOKEN as token aliases. TOGGL_CACHE_TTL, TOGGL_CACHE_SIZE, and TOGGL_BATCH_SIZE control cache duration, entity capacity, and API pagination batch size. It can alternatively be installed globally with npm and started using the mcp-toggl command.

Tools and capabilities

The mcp-toggl MCP server includes these tool groups:

  • Reports: daily reports, weekly reports, hydrated time entries, project summaries, and workspace summaries.
  • Timer control: read the active entry, start a timer with a description and optional project or tags, and stop the active timer.
  • Lookups: check authentication, list workspaces, list projects, and list clients.
  • Cache management: warm, inspect, and clear cached entity data.
  • Timeline analysis: summarize Toggl Track Desktop application usage and optionally return raw activity events.

Timeline requests can omit raw events with include_events: false or redact window titles with redact_titles: true. This matters because titles may contain document names, email subjects, chat content, URLs, or database names.

Limitations and notes

The mcp-toggl MCP server cannot provide desktop activity unless Toggl Track Desktop timeline synchronization is enabled and data has uploaded. Timeline limit restricts returned raw events, not the totals calculated across matching events. Running Toggl entries use negative duration values, so clients should use the hydrated running and elapsed_seconds fields instead.

Toggl rate limits and quotas may affect chatty sessions. Warming the cache can reduce repeated entity requests, but it does not remove Toggl service limits. After creating or renaming entities, clear the cache before relying on refreshed lookup results. The project is licensed under MIT.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about MCP Toggl

mcp-toggl is an MCP server that connects AI clients to Toggl Track through its API. Its main tools provide time reports, hydrated time entries, timer status and control, workspace and project lookups, cache management, and optional Toggl Track Desktop activity timelines for structured analysis.

Install it with Node.js using npx or npm. Claude Desktop can run `npx -y @verygoodplugins/mcp-toggl@latest`; alternatively, install `@verygoodplugins/mcp-toggl` globally and start the `mcp-toggl` command.

Set `TOGGL_API_KEY` to your Toggl API token. `TOGGL_DEFAULT_WORKSPACE_ID` is optional, while `TOGGL_API_TOKEN` and `TOGGL_TOKEN` are supported token aliases. Cache and pagination settings are optional.

Yes, if Toggl Track Desktop timeline synchronization is enabled and has uploaded data. `toggl_get_timeline` can return summaries, raw events, or redacted titles; use `include_events: false` for summary-only output.

Yes. Configure it as a stdio server in Claude Desktop using the documented npx command and provide `TOGGL_API_KEY`. Restart Claude Desktop before sending requests such as a current-timer query.

Related MCP servers

All in Workplace & Productivity All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMCP Toggl AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/mcp-toggl?style=directory)](https://allmcps.com/mcp/mcp-toggl)
HTML Embed
<a href="https://allmcps.com/mcp/mcp-toggl"><img src="https://allmcps.com/api/badge/mcp-toggl?style=directory" alt="MCP Toggl on AllMCPs" /></a>