V
verygoodplugins/mcp-toggl
Time entries and reports in Toggl Track
View on GitHub ↗Link checked 2026-11-12 · HTTP 200 · opens the vendor's own site
Install & config
Client config (built from the install command this repo gives)
{
"mcpServers": {
"verygoodplugins-mcp-toggl": {
"command": "npx",
"args": ["-y", "@verygoodplugins/mcp-toggl@latest"]
}
}
}Parsed from the README we fetched on 2026-11-05; we have not executed it.
command/args come from the install command the repository states. When it is ambiguous, the project README wins.
VS Code (.vscode/mcp.json - the key is servers)
{
"servers": {
"verygoodplugins-mcp-toggl": {
"command": "npx",
"args": ["-y", "@verygoodplugins/mcp-toggl@latest"]
}
}
}Same server, but VS Code keeps it under <code>servers</code>.
Claude Code (command line)
claude mcp add --transport stdio verygoodplugins-mcp-toggl -- npx -y @verygoodplugins/mcp-toggl@latest
Claude Code does not read a config file; add the server with this command.
Key names differ by client: Clients & CLI
- Source
- collected from the abordage/awesome-mcp list · type: MCP server
- Harvest history
- first seen 2026-11-05 · last seen 2026-11-14 · seen 10× · listed by 10 sources
- Score
- score 1,003 · 10 sources · mcp
- Install
npx -y @verygoodplugins/mcp-toggl@latest
FAQ (answers come from our records)
How do I install it?
The repository provides this install command:
npx -y @verygoodplugins/mcp-toggl@latest. It comes from the repository itself; we cannot guarantee it runs as-is in your client.Who is it for?
We filed it under these tags: MCP 服务. The tags come from the entry itself, not a taxonomy we imposed.
Who maintains it?
first catalogued 2026-11-05；last seen 2026-11-14。There is no official certification or quality rating here — we record sources and dates only.
# MCP Toggl
以下摘录自该仓库的 README（片段） · 在 GitHub 读完整 README →
> Talk to your time tracking. Pull reports, start timers, inspect desktop activity, and turn raw Toggl data into useful recaps from Claude or any MCP-compatible client.
## See What Your Week Actually Looked Like
> You ask: "Give me the recap of my week"
The MCP server returns hydrated time entries with project, workspace, client, tag, and running-timer context. Your client can turn that into a readable recap:
> 32.7 hours across 31 entries and 7 projects. Monday was a light planning day, Tuesday had the long implementation block, Wednesday stayed focused on one project, and Friday turned into a shipping run. The top project took 27% of the week, with two smaller projects close behind.
The server does not hard-code this prose or chart. It exposes structured Toggl data in a shape that makes synthesis easy.
## Catch the Drift
> You ask: "Did I actually work on what I said I worked on for that PR review entry?"
togglgettimeline can compare a tracked entry boundary with Toggl Track Desktop activity:
> The entry ran 1h 33m. About 67 minutes were in review tools, 5 minutes were scattered across chat apps, and the rest was idle or trimmed timeline space. The entry mostly checks out.
This is useful before invoicing, after long context-switching days, or whenever a vague entry like "admin" starts hiding too much Slack and browser time.
## See Patterns Over Time
> You ask: "Show me last month at a glance"
Daily and weekly report tools make it straightforward for the client to render heatmaps, spot streaks, and surface intensity changes:
Toggl is still the source of truth. The MCP layer makes the data easier for an agent to inspect, summarize, and visualize.
## Things You Can Ask
text
What am I currently tracking?
How much time did I spend on the website project this month?
Start a timer for "PR review" on the Platform project
Show me yesterday's hours as a chart
What apps did I use most today?
Generate a daily report for last Friday
Compare this week to last week by project
Which day this month had the most billable work?
Chart prompts depend on your MCP client. The server returns the structured data; clients such as Claude decide how to render it.
## What Makes This Useful
Hydrated responses: time entries are enriched with projectname, clientname, workspacename, tagnames, and normalized running-timer fields so the client does not need a second lookup for ordinary reporting.
Smart caching: workspaces, projects, clients, tasks, and tags are cached after first read. togglcachestats shows hits, misses, loaded entities, and hit rate.
Desktop activity timeline: togglgettimeline summarizes app usage from Toggl Track Desktop and can return raw events when you need sequence analysis.
Privacy controls: timeline calls support summary-only output with includeevents: false and title redaction with redacttitles: true.
Period shortcuts: today, yesterday, week, lastWeek, month, and lastMonth are supported on the tools where those periods make sense.
Recoverable errors: workspace resolution errors include availableworkspaces, and Toggl quota/rate-limit errors include structured retry hints.
## Quick Start
### Prerequisites
Node.js ^20.19.0 or >=22.12.0
## See What Your Week Actually Looked Like
> You ask: "Give me the recap of my week"
The MCP server returns hydrated time entries with project, workspace, client, tag, and running-timer context. Your client can turn that into a readable recap:
> 32.7 hours across 31 entries and 7 projects. Monday was a light planning day, Tuesday had the long implementation block, Wednesday stayed focused on one project, and Friday turned into a shipping run. The top project took 27% of the week, with two smaller projects close behind.
The server does not hard-code this prose or chart. It exposes structured Toggl data in a shape that makes synthesis easy.
## Catch the Drift
> You ask: "Did I actually work on what I said I worked on for that PR review entry?"
togglgettimeline can compare a tracked entry boundary with Toggl Track Desktop activity:
> The entry ran 1h 33m. About 67 minutes were in review tools, 5 minutes were scattered across chat apps, and the rest was idle or trimmed timeline space. The entry mostly checks out.
This is useful before invoicing, after long context-switching days, or whenever a vague entry like "admin" starts hiding too much Slack and browser time.
## See Patterns Over Time
> You ask: "Show me last month at a glance"
Daily and weekly report tools make it straightforward for the client to render heatmaps, spot streaks, and surface intensity changes:
Toggl is still the source of truth. The MCP layer makes the data easier for an agent to inspect, summarize, and visualize.
## Things You Can Ask
text
What am I currently tracking?
How much time did I spend on the website project this month?
Start a timer for "PR review" on the Platform project
Show me yesterday's hours as a chart
What apps did I use most today?
Generate a daily report for last Friday
Compare this week to last week by project
Which day this month had the most billable work?
Chart prompts depend on your MCP client. The server returns the structured data; clients such as Claude decide how to render it.
## What Makes This Useful
Hydrated responses: time entries are enriched with projectname, clientname, workspacename, tagnames, and normalized running-timer fields so the client does not need a second lookup for ordinary reporting.
Smart caching: workspaces, projects, clients, tasks, and tags are cached after first read. togglcachestats shows hits, misses, loaded entities, and hit rate.
Desktop activity timeline: togglgettimeline summarizes app usage from Toggl Track Desktop and can return raw events when you need sequence analysis.
Privacy controls: timeline calls support summary-only output with includeevents: false and title redaction with redacttitles: true.
Period shortcuts: today, yesterday, week, lastWeek, month, and lastMonth are supported on the tools where those periods make sense.
Recoverable errors: workspace resolution errors include availableworkspaces, and Toggl quota/rate-limit errors include structured retry hints.
## Quick Start
### Prerequisites
Node.js ^20.19.0 or >=22.12.0
Listed badge (optional)
Copy this line into the README if you want the listing mark. Optional, and it does not affect being listed.
[](https://anclum.com/en/s/verygoodplugins-mcp-toggl/)
- Source
- awesome · https://github.com/verygoodplugins/mcp-toggl
- Browse by field
- MCP servers
- Listed by
- 10 independent sources
- added
- today
More like this
Filed under
Every tag opens the full list for that filter. Counts are the live catalogue figures.