mcp-toggl

Overview

MCP Toggl provides a comprehensive interface between Toggl Track time tracking and MCP-compatible clients. It offers structured data retrieval with hydrated entries including project, workspace, client, and tag information. The server implements smart caching to reduce API calls and supports timeline analysis from Toggl Track Desktop, allowing users to analyze how their tracked time actually maps to application usage patterns.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• toggl_daily_report

  Hours by project and workspace for a date

  Try:What am I tracking today?Try:Show me yesterday's hours as a chart
• toggl_weekly_report

  7-day breakdown with daily totals and project rollups

  Try:Give me a recap of my weekTry:Compare this week to last week by project
• toggl_get_time_entries

  Raw hydrated entries by period, date range, workspace, or project

  Try:What am I currently tracking?Try:How much time did I spend on the website project this month?
• toggl_get_timeline

  Toggl Track Desktop app usage summary with optional raw events

  Try:Did I actually work on what I said I worked on for that PR review entry?Try:What apps did I use most today?
• toggl_get_current_entry

  Returns the running timer, elapsed seconds, and hydrated project/workspace context

  Try:What am I currently tracking?Try:How long has my current timer been running?
• toggl_start_timer

  Starts a timer with description, optional project/task, and tags

  Try:Start a timer for "PR review" on the Platform projectTry:Begin tracking client meeting time
• toggl_stop_timer

  Stops the currently running timer

  Try:Stop my current timerTry:End the running task
• toggl_check_auth

  Verifies token access and lists available workspaces without exposing the token

  Try:Check if my Toggl connection is workingTry:What workspaces do I have access to?
• toggl_list_workspaces

  Lists all accessible workspaces

  Try:List my Toggl workspacesTry:What workspaces do I have?
• toggl_list_projects

  Lists projects for a workspace using cache-backed reads after first fetch

  Try:Show me my projectsTry:What projects are available in my main workspace?
• toggl_warm_cache

  Pre-fetches workspace, project, client, and tag data before a heavy reporting session

  Try:Warm up the Toggl cacheTry:Prepare data for my weekly report
• toggl_project_summary

  Total hours per project for a period or date range

  Try:Which project took the most time this month?Try:Show me my project totals for last week

Comparable tools

Installation

{
  "mcpServers": {
    "mcp-toggl": {
      "command": "npx",
      "args": ["-y", "@verygoodplugins/mcp-toggl@latest"],
      "env": {
        "TOGGL_API_KEY": "your_api_key_here",
        "TOGGL_DEFAULT_WORKSPACE_ID": "123456"
      }
    }
  }
}

npm install -g @verygoodplugins/mcp-toggl
mcp-toggl --help

FAQ

What makes this MCP server different from using Toggl directly?

This server enriches raw time entries with project, client, and workspace data in a single API call, implements smart caching to reduce API requests, provides timeline analysis of actual desktop activity, and delivers structured data in a format optimized for AI consumption and reporting.

How does the timeline privacy feature work?

The timeline feature supports three modes: summary-only (no raw events), events with redacted titles (preserving duration but removing sensitive information), and full event mode. Users can control privacy by setting include_events: false or redact_titles: true.

Compare mcp-toggl with