@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):
{
"mcpServers": {
"toggl": {
"command": "npx",
"args": ["-y", "@louis030195/toggl-mcp"],
"env": {
"TOGGL_API_KEY": "your-toggl-api-key"
}
}
}
}
Claude Code
# Install globally in user scope with API key
claude mcp add -s user toggl npx -e TOGGL_API_KEY=your-toggl-api-key -- -y @louis030195/toggl-mcp
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
# Clone the repo
git clone https://github.com/louis030195/toggl-mcp.git
cd toggl-mcp
# Install dependencies
npm install
# Build
npm run build
# Run locally
TOGGL_API_KEY=your-api-key npm start
License
MIT