Toggl Track MCP Server
Check and control running Toggl Track timers, pull time entries, and get daily, weekly, project and workspace summaries, plus Toggl Track Desktop activity timelines.
- Maintained by
- Community (Very Good Plugins)
- Hosting
- Runs locally on your machine
- Authentication
- API key or credentials (environment variables)
- Last checked
Uses your Toggl Track API token; the activity timeline requires Toggl Track Desktop timeline sync.
How to connect the Toggl Track MCP server
Pick your AI client and paste the snippet. Swap the YOUR_… placeholders for your own values. New to this? Our guide to how MCP clients and servers fit together explains what each piece does.
Claude Code
claude mcp add --env TOGGL_API_KEY=YOUR_TOGGL_API_TOKEN --transport stdio toggl-track \
-- npx -y @verygoodplugins/mcp-toggl@latestClaude Desktop
{
"mcpServers": {
"toggl-track": {
"command": "npx",
"args": [
"-y",
"@verygoodplugins/mcp-toggl@latest"
],
"env": {
"TOGGL_API_KEY": "YOUR_TOGGL_API_TOKEN"
}
}
}
}Fully quit and reopen Claude Desktop after saving.
Full Claude Desktop setup guide →Cursor
{
"mcpServers": {
"toggl-track": {
"command": "npx",
"args": [
"-y",
"@verygoodplugins/mcp-toggl@latest"
],
"env": {
"TOGGL_API_KEY": "YOUR_TOGGL_API_TOKEN"
}
}
}
}VS Code
{
"servers": {
"toggl-track": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@verygoodplugins/mcp-toggl@latest"
],
"env": {
"TOGGL_API_KEY": "YOUR_TOGGL_API_TOKEN"
}
}
}
}Frequently asked questions
What is the Toggl Track MCP server?
It is a Model Context Protocol (MCP) server — a small piece of software that gives AI assistants like Claude a secure, governed connection to Toggl Track. Check and control running Toggl Track timers, pull time entries, and get daily, weekly, project and workspace summaries, plus Toggl Track Desktop activity timelines.
Is there an official Toggl Track MCP server?
Not from Toggl Track itself. This one is community-maintained (Very Good Plugins). It is widely used, but review the repository and pin a version before relying on it in production.
Is the Toggl Track MCP server hosted, or do I run it myself?
It runs locally. Your AI client starts it on your own machine with npx, and it talks to the client over standard input and output rather than the network.
Do I need an API key for the Toggl Track MCP server?
Yes. The local server reads TOGGL_API_KEY from its environment, so you create that credential first and add it to your client's config.
What can an AI assistant actually do with Toggl Track?
Through this server an assistant can work with start and stop timers, get time entries, daily and weekly reports, project summaries, activity timeline — reading from and acting on Toggl Track directly instead of you copy-pasting between windows. What you allow it to do is controlled by the permissions you grant.
How do I set this up for my business?
The setup section above has copy-paste config for Claude Code, Claude Desktop, Cursor and VS Code. If you want it rolled out across a team with permissions, governance and support handled, that is what Crox's Build engagement covers.
New to MCP? Start with our plain-English guide to the Model Context Protocol or see how to connect AI to your business tools without writing code .
Want this connected to your business — with governance handled?
Crox maps your processes, connects AI to the tools you already use, and keeps it working as models change. Start with a readiness assessment or talk to us about a build.