toggl-track-mcp

MCP server for Toggl Track — full CRUD for time entries, projects, clients, tags, tasks, and Reports API v3.

Quick Start

Install

# Using uvx (no install needed)
uvx toggl-track-mcp

# Or install with pip
pip install toggl-track-mcp

Configure

Set your Toggl API token (get it from https://track.toggl.com/profile):

export TOGGL_API_TOKEN="your-api-token"

Optionally set a default workspace:

export TOGGL_WORKSPACE_ID="your-workspace-id"

Claude Desktop Configuration

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "toggl-track": {
      "command": "uvx",
      "args": ["toggl-track-mcp"],
      "env": {
        "TOGGL_API_TOKEN": "your-api-token"
      }
    }
  }
}

Claude Code Configuration

claude mcp add toggl-track -- uvx toggl-track-mcp

Then set the env var TOGGL_API_TOKEN in your shell.

Available Tools (35)

Time Entries (8)

Projects (5)

Clients (7)

Tags (4)

Tasks (5)

Workspaces (3)

Reports (3)

Example Prompts

• "Start a timer for code review on Project X"
• "What am I currently tracking?"
• "Stop my current timer"
• "Show me a summary of hours this week"
• "List all projects in my workspace"
• "Create a new client called Acme Corp"
• "How much time did I spend on Project Y last month?"

Development

# Clone and install
git clone https://github.com/youruser/toggl-track-mcp.git
cd toggl-track-mcp
uv sync --extra dev

# Run tests
uv run pytest

# Run the server locally
TOGGL_API_TOKEN=your-token uv run toggl-track-mcp

License

MIT