Toggl MCP

What louis030195/toggl-mcp MCP server does

The louis030195/toggl-mcp MCP server exposes Toggl Track time-tracking actions as MCP tools. It supports both active-timer operations and reporting workflows, so an MCP client can record work, inspect the current session, and review accumulated hours.

The available operations include starting a timer with a description and optional project, stopping the running timer, and retrieving details about the current timer. Agents can also list projects in the connected workspace and remove a time entry by ID. Reporting tools return today's entries and total duration, or a weekly view with total hours, daily totals, project totals, and the underlying entries.

How it works

The server runs locally as a Node-based MCP process and uses the Toggl API token supplied through its environment. An MCP client sends tool calls over the local server connection; the server then performs the corresponding Toggl Track operation.

Weekly reporting accepts an optional week_offset value. Zero represents the current week, -1 selects the previous week, and more negative values select earlier weeks. The toggl_last_week tool provides the previous-week case directly and is equivalent to calling the weekly tool with week_offset: -1.

Setup and configuration

The louis030195/toggl-mcp MCP server requires the TOGGL_API_KEY environment variable. The README directs users to the API Token section of their Toggl Track profile to obtain the value.

For Claude Desktop, add a server entry that runs npx -y @louis030195/toggl-mcp and passes TOGGL_API_KEY in the entry's environment. The README also gives a Claude Code command using the same package and environment variable. For local development, clone the repository, run npm install, build with npm run build, and start it with TOGGL_API_KEY set.

Tools and capabilities

• toggl_start: starts a timer with a description and optional project.
• toggl_stop: stops the currently running timer.
• toggl_current: returns information about the active timer.
• toggl_today: lists today's entries and their total duration.
• toggl_projects: lists projects in the workspace.
• toggl_delete: deletes a time entry using its ID.
• toggl_weekly: reports weekly totals, daily and project breakdowns, and all entries for the selected week.
• toggl_last_week: returns the previous week's report.

Limitations and notes

The louis030195/toggl-mcp MCP server is focused on the operations documented in the repository. The material does not describe editing existing entries, creating projects, changing workspace settings, or supporting multiple Toggl accounts. Deletion requires the relevant time-entry ID, while starting a timer accepts a project optionally rather than requiring one.

The documented client configuration specifically covers Claude Desktop and Claude Code. The README also states that the server can be used with ChatGPT or other LLM clients that support MCP, but it does not provide configuration instructions for those clients.