MCP.Market

Toggl MCP server

by souravpn·io.github.souravpn/toggl-mcp·v1.0.0
No reviews yet

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

B72/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B72/100

full report

Adoption
New

0 stars22 downloads/wk

Reviews

Write one

Nobody has reviewed Toggl yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Toggl tools (7)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • get_current_timer

    Get the currently running Toggl time entry, if any

  • get_profile

    Get the user's Toggl profile — name, email, timezone, and workspace info

  • get_projects

    List all Toggl projects in your workspace

  • get_recent_entries

    Get time entries from the past N days (default 7). Useful for reviewing what you worked on.

  • get_summary

    Get total time tracked per project for a date range. Defaults to the current week.

  • start_timer

    Start a new Toggl time entry. Provide a description and optionally a project name.

  • stop_timer

    Stop the currently running Toggl time entry

Public scan report

scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it

no findings
  • Code scan5 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 123 days ago8/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 72/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Toggl compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
72/100
higher than 38% of 48,255 servers
Tools
7
the typical server has 7
Tools that change things
0%
typical: 0%. Fewer write tools means less an agent can break
Downloads a week
22
more than 8% of 12,191 servers with a package

What its tools let an agent do: 5 read · 2 run or deploy

Install Toggl in Claude Code, Cursor or VS Code

Runs npx -y @souravpn/toggl-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add toggl-mcp -- npx -y @souravpn/toggl-mcp
Add to Cursor

What the publisher says

From the Toggl repository's README, as published. We do not edit it. Read it on GitHub

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

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

npm install -g toggl-mcp

Find the installed path:

which toggl-mcp

3. Add to Claude Desktop

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

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

Or if running from source:

{
  "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

git clone https://github.com/yourusername/toggl-mcp
cd toggl-mcp
npm install
npm run build

# Test locally
TOGGL_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.

Nothing above is checked by us. What we check is on the safety report.

Toggl: common questions

Is Toggl MCP server safe?
Mostly: it is graded B (72/100). Read the Toggl safety report
How do I install Toggl?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Toggl need an API key?
Yes. The registry entry asks for TOGGL_API_TOKEN.
Is Toggl maintained?
The last commit was 161 days ago (2026-05-27). The latest release is v1.0.0.
How does Toggl compare with other MCP servers?
safety score 72/100 (higher than 38% of 48,255 servers); tools 7 (the typical server has 7); tools that change things 0% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.