Overview
Lazy Toggl MCP Server is an MCP server that provides tools for interacting with Toggl time tracking. It exposes MCP actions to start and stop time tracking, fetch the current running entry, and list workspaces. The server leverages Toggl Track API v9 endpoints, including GET /me, GET /workspaces, GET /me/time_entries/current, POST /workspaces/{workspace_id}/time_entries, and PATCH /workspaces/{workspace_id}/time_entries/{time_entry_id}/stop. Start_tracking accepts inputs: title (string), workspace_id (optional integer), project_id (optional integer), and tags (optional string[]); stop_tracking requires no inputs; list_workspaces requires no inputs and returns workspace IDs and names; show_current_time_entry returns the current task details or a message when nothing is running. Configuration uses an environment variable TOGGL_API_TOKEN to authenticate. Installation involves cloning the project, installing dependencies via uv sync, and running the server with uv run as specified in the configuration. The project structure includes src/toggl_server with modules for the API client, data models, utilities, and the main MCP server entry point, plus a CLI, server.py, and configuration files. This server is intended for developers seeking to automate Toggl time tracking within MCP workflows.
Features
start_tracking
Start tracking time for a new task. Accepts inputs: title, optional workspace_id, optional project_id, and optional tags; creates a new Toggl time entry.
stop_tracking
Stop the currently running time entry; requires no inputs and returns a confirmation.
list_workspaces
List all available workspaces; no input required; returns IDs and names of workspaces.
show_current_time_entry
Show the currently running time entry; returns details such as description, entry_id, workspace, start time, duration, tags, and project (if any), or a message if no entry is running.
