start_trackingLABSCO SUMMARY
Tracking time stops being the thing you forget to do.
Starting a timer is a sentence inside the conversation you were already having, which is the only reason it actually gets started. The current-entry tool answers the other half - whether something has been running since this morning.
What it is
A small Toggl Track server: start a timer with a description, stop the one that is running, and see what is currently being tracked.
What you get
- A timer started for a task you describe, optionally against a workspace, a project and tags
- The running time entry stopped, with confirmation of what was stopped
- The current entry in full: description, workspace, start time, running duration, tags and project - or a clear answer that nothing is running
- Every workspace on the account, with its ID and name
Requirements
A Toggl Track account and its API token, copied from your profile settings into the MCP client config. It runs with uv from a local checkout.
Setup effort
Build from source — git clone https://github.com/movstox/lazy-toggl-mcp.git
USE CASES
01
Starting the clock without breaking focus
Say what you are about to work on and let the timer start from that, with tags and a project attached if they matter.
02
Checking whether you left a timer running
Ask what is currently tracked and get the description and running duration back, then stop it if it should have ended hours ago.
03
Tracking against the right project
See which workspaces the account has before starting, so the entry lands where the billing report will look for it.
04
Closing out at the end of a task
Stop the entry and read back what was recorded, so the log is right before you move on.
4 tools
Listed in project docs. Your client may show a different list.
stop_trackinglist_workspacesshow_current_time_entryBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
TOGGL_API_TOKEN in your environment
Where it runs
The documented client runs the server on your machine.
INSTALLATION
Connect your client
You clone this one yourself.
Server setup
TERMINAL
git clone https://github.com/movstox/lazy-toggl-mcp.git
cd lazy-toggl-mcp
uv syncMCP Clients
Any MCP client
ANY MCP CLIENT · JSON
{
"mcpServers": {
"lazy-toggl-mcp": {
"autoApprove": [],
"disabled": false,
"timeout": 60,
"type": "stdio",
"transportType": "stdio",
"command": "uv",
"args": [
"run",
"--directory",
"<YOUR_PATH_TO_LAZY_TOGGL_MCP>",
"python",
"server.py"
],
"env": {
"TOGGL_API_TOKEN": "<YOUR_TOGGL_API_TOKEN>"
}
}
}
}
