Toggl Track MCP Server

What is Toggl Track MCP Server?

A Model Context Protocol (MCP) server that integrates with Toggl Track’s API to let Claude and other MCP clients manage projects and time entries. It is designed for users who want to query, create, and control their time tracking data through natural language conversations.

How to use Toggl Track MCP Server?

Obtain a Toggl Track API token from your profile settings, then build the provided Docker image and configure Claude Desktop with your token in the claude_desktop_config.json file. Restart Claude Desktop and ask questions like “What projects do I have?” or “Start a timer for ‘Code review’.”

Key features of Toggl Track MCP Server

• Retrieve all projects and workspaces from your Toggl Track account.
• Get detailed time entries with date range and project filtering.
• View aggregated time summaries by project with percentages.
• Check current running timer and elapsed time.
• Start and stop timers with optional project assignment.
• Create and retrieve project tasks with time estimates.
• Search time entries by description text.
• Pre-built conversation starters for common time tracking queries.
• Secure API token authentication via environment variable.

Use cases of Toggl Track MCP Server

• Analyze your weekly time entries per project to understand how you spend time.
• Quickly start or stop a timer without leaving your chat with Claude.
• Generate a productivity report by project for a given date range.
• View and manage tasks for a specific project, including creating new ones with estimates.

FAQ from Toggl Track MCP Server

What do I need to use this server?

You need a Toggl Track account and an API token (found in your profile settings) provided via the TOGGL_API_TOKEN environment variable.

How do I install the server?

Clone the repository, build the Docker image with docker build -t toggl-track-mcp ., then configure Claude Desktop to run the container with your API token set in the environment.

How does authentication work?

The server uses Toggl Track’s API token authentication. The token is passed through the TOGGL_API_TOKEN environment variable. Never commit the token to version control.

Are there rate limits?

Yes, the Toggl Track API allows approximately one request per second. The server respects this limit and provides appropriate error messages if exceeded.

What Toggl Track API version does it use?

The server uses Toggl Track API v9. Key endpoints are documented in the server’s README.