Provides tools for controlling Toggl time tracking, including starting/stopping timers, viewing current and daily time entries, managing projects, deleting entries, and generating weekly time summaries with breakdowns by day and project.
@louis030195/toggl-mcp
Dead simple MCP (Model Context Protocol) server for Toggl time tracking. Control your Toggl timer directly from Claude, ChatGPT, or any LLM that supports MCP.
Features
⏱️ Start/stop timers
📊 View current timer
📈 Get today's time entries
🗂️ List projects
🗑️ Delete time entries
Installation
Claude Desktop
Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):
Claude Code
Get Your Toggl API Key
Go to Toggl Track Profile
Scroll down to "API Token"
Click "Click to reveal" and copy your token
Usage
Once configured, you can use natural language to control Toggl:
"Start tracking work on the MCP server project"
"Stop the current timer"
"What am I currently tracking?"
"Show me today's time entries"
"List all my projects"
Tools
toggl_start
Start a new timer with a description and optional project.
toggl_stop
Stop the currently running timer.
toggl_current
Get information about the currently running timer.
toggl_today
Get all time entries for today with total duration.
toggl_projects
List all projects in your workspace.
toggl_delete
Delete a time entry by its ID.
toggl_weekly
Get weekly time tracking summary with total hours and breakdowns.
Parameters:
week_offset(optional, number)0= current week-1= last week-2= two weeks ago, etc.
Returns:
Total hours for the week
Daily breakdown (hours per day)
Project breakdown (hours per project)
Full list of entries
toggl_last_week
Convenience function to get last week's time tracking summary (equivalent to toggl_weekly with week_offset: -1).
Development
License
MIT