Toggl Mcp

io.github.souravpnPublished by GitHub account souravpnv1.0.0Updated Oct 24, 2026

MCP server for Toggl Track — gives Claude access to your time tracking data

VerifiedSTDIODesktop onlyProductivity & WorkflowData & Analytics

Overview

AI-generated overview

A local MCP server that connects Claude to Toggl Track, letting it read your time entries and projects and start or stop timers.

What you can do
Check the currently running timer and recent time entries for the past days (default 7). List projects and show the profile and workspaces. Summarize total time by project over a date range. Start a new time entry or stop the running timer.
When to use it
Useful if you track work in Toggl Track and want to ask about your day or week, review time per project, or start and stop timers by conversation instead of opening the Toggl app.
Requirements
Runs locally as an npm package (Node.js) configured in Claude Desktop. Requires a Toggl Track API token supplied in the TOGGL_API_TOKEN environment variable, plus network access to the Toggl API. Desktop only.
Before you install
The Toggl API token is a secret stored in the client configuration; anyone with it can access your Toggl account data. The server can start and stop timers, which changes your tracked records. Toggl's free plan allows 30 requests per hour per workspace, so heavy querying may hit limits.

Installation

In SourceWeft

  1. Open Toggl Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

toggl-mcp

A Model Context Protocol (MCP) server that gives Claude access to your Toggl Track time tracking data.

Ask Claude things like:

  • "What am I tracking right now?"
  • "How much time did I spend on each project this week?"
  • "Start a timer for writing documentation on the Blog project"
  • "Stop my timer"
  • "What did I work on yesterday?"

Tools

ToolWhat it does
get_current_timerShows the currently running time entry
get_recent_entriesTime entries for the past N days (default 7)
get_projectsLists all your projects
get_summaryTotal time by project for a date range
start_timerStarts a new time entry
stop_timerStops the current timer
get_profileYour Toggl profile and workspaces

Setup

1. Get your API token

  1. Go to https://track.toggl.com/profile
  2. Scroll to the bottom
  3. Click "Click to reveal" under API Token
  4. Copy the token

2. Install

bash
npm install -g toggl-mcp

Find the installed path:

bash
which toggl-mcp

3. Add to Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

json
{  "mcpServers": {    "toggl": {      "command": "/path/from/which/toggl-mcp",      "env": {        "TOGGL_API_TOKEN": "your_token_here"      }    }  }}

Or if running from source:

json
{  "mcpServers": {    "toggl": {      "command": "node",      "args": ["/path/to/toggl-mcp/dist/index.js"],      "env": {        "TOGGL_API_TOKEN": "your_token_here"      }    }  }}

Restart Claude Desktop. You should see a green "running" badge in Settings → Developer.

4. Test it

What am I currently tracking in Toggl?

Example queries

Daily check-in:

What have I tracked today in Toggl?

Weekly review:

Give me a summary of how I spent my time this week by project

Start tracking:

Start a Toggl timer for "reviewing PRs" on my Engineering project

Stop and summarize:

Stop my timer and tell me how long I worked

Productivity analysis:

How much time did I track last week vs the week before?Which project took the most time?

Development

bash
git clone https://github.com/yourusername/toggl-mcpcd toggl-mcpnpm installnpm run build
# Test locallyTOGGL_API_TOKEN=your_token node dist/index.js

Project structure

toggl-mcp/├── src/│   ├── index.ts   # MCP server + tool definitions│   └── toggl.ts   # Toggl API v9 client + formatters├── package.json├── tsconfig.json└── README.md

Rate limits

Toggl's free plan allows 30 requests/hour per workspace. This MCP server batches calls where possible (e.g. fetching projects and entries in parallel) to stay well within limits for normal use.

Contributing

PRs welcome. Ideas for extension:

  • Tags management
  • Client listing
  • Detailed reports (daily breakdown)
  • Time entry editing

License

MIT

Acknowledgements

Built with the MCP TypeScript SDK and the Toggl Track API v9.

Source: README.md at commit 4fc0db9

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.