Lazy Toggl MCP

Simple unofficial MCP server to track time via Toggl API

View on GitHub →

Lazy Toggl MCP Server

A Model Context Protocol (MCP) server that provides tools for interacting with Toggl time tracking.

Features

  • Start/stop time tracking
  • Get current entry
  • List workspaces

API

Tools

  • start_tracking

    • Start tracking time for a new task
    • Inputs:
      • title (string): Title/description of the task to track
      • workspace_id (integer): Workspace ID (optional, uses default if not provided)
      • project_id (integer): Project ID (optional)
      • tags (string[]): List of tags (optional)

  • stop_tracking

    • Stop the currently running time entry
    • No input required
    • Returns confirmation of stopped time entry

  • list_workspaces

    • List all available workspaces
    • No input required
    • Returns list of workspaces with their IDs and names

  • show_current_time_entry

    • Show the currently running time entry, if any
    • No input required
    • Returns:
      • If tracking: Task description, entry ID, workspace, start time, running duration, tags, and project (if any)
      • If not tracking: A message indicating no time entry is currently running

Integration with Toggl Track API

This server uses the Toggl Track API v9. The following endpoints are utilized:

  • GET /me - Get user information
  • GET /workspaces - List workspaces
  • GET /me/time_entries/current - Get current running time entry
  • POST /workspaces/{workspace_id}/time_entries - Start time tracking
  • PATCH /workspaces/{workspace_id}/time_entries/{time_entry_id}/stop - Stop time tracking

Installation

  1. Clone/create this project
  2. Install dependencies with uv: 
    cd lazy-toggl-mcp
uv sync

Configuration

Get Your Toggl API Token

  1. Go to Toggl Track
  2. Sign in to your account
  3. Click on your profile picture/avatar in the top right corner
  4. Go to "Profile" or "Settings"
  5. Find your "API Token" - copy this long string of characters

Configure MCP Server

Add the following configuration to your MCP settings file:

{
  "mcpServers": {
    "lazy-toggl-mcp": {
      "autoApprove": [],
      "disabled": false,
      "timeout": 60,
      "type": "stdio",
      "transportType": "stdio",
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/lazy-toggl-mcp",
        "python",
        "server.py"
      ],
      "env": {
        "TOGGL_API_TOKEN": "your-actual-api-token-here"
      }
    }
  }
}

Important: Replace /path/to/lazy-toggl-mcp with the actual path to this project and your-actual-api-token-here with your real Toggl API token.

Project Structure

lazy-toggl-mcp/
├── src/
│   └── toggl_server/
│       ├── __init__.py      # Package initialization
│       ├── main.py          # MCP server implementation (new structure)
│       ├── models.py        # Data models and type definitions
│       ├── toggl_api.py     # Toggl API client
│       └── utils.py         # Utility functions
├── main.py                  # CLI interface for testing
├── server.py                # Main MCP server entry point
├── pyproject.toml           # Project configuration and dependencies
├── README.md                # This file
├── uv.lock                  # Dependency lock file
├── .gitignore               # Git ignore patterns
└── .python-version          # Python version specification

License

MIT License - feel free to modify and use as needed.

Related Servers