Toggl MCP Server
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.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Toggl MCP Server show me my time entries for today"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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
Related MCP server: Toggl MCP Server
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-mcpGet 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 startLicense
MIT
Author
Available Tools
8 toolstoggl_currentA
Get the currently running time entry
Inputs: no named parameters.
toggl_deleteC
Delete a time entry by ID
Inputs: entry_id (required).
toggl_last_weekB
Get last week's time tracking summary
Inputs: no named parameters.
toggl_projectsB
List all projects in the workspace
Inputs: no named parameters.
toggl_startB
Start a new time tracking entry
Inputs: description (required), project_name.
toggl_stopB
Stop the currently running timer
Inputs: no named parameters.
toggl_todayB
Get today's time entries with total duration
Inputs: no named parameters.
toggl_weeklyC
Get weekly time tracking summary with total hours, daily/project breakdowns
Inputs: week_offset.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose with no ambiguity: toggl_current and toggl_stop handle the active timer, toggl_start initiates tracking, toggl_delete removes entries, and the summary tools (toggl_today, toggl_last_week, toggl_weekly) provide different timeframes. The tools toggl_projects stands alone for workspace management. There is no overlap in functionality that would cause misselection.
All tools follow a consistent 'toggl_verb' or 'toggl_noun' pattern with clear, descriptive names. The naming is uniform across all eight tools, using lowercase with underscores, making it predictable and easy to understand. There are no deviations in style or convention.
With 8 tools, the server is well-scoped for time tracking and project management. Each tool earns its place by covering essential operations like starting/stopping timers, viewing summaries, managing entries, and listing projects. This count is neither too sparse nor overwhelming for the domain.
The tool set provides strong coverage for core time tracking workflows, including CRUD operations (create via toggl_start, read via summary tools, delete via toggl_delete) and project listing. A minor gap exists in updating time entries (e.g., modifying descriptions or projects), but agents can work around this by deleting and recreating entries. Overall, it supports most common user actions without dead ends.
Maintenance
Related MCP Connectors
Read your tracked time and projects, pause tracking or add a note, from Claude or ChatGPT.
Connects AI assistants to TrackingTime for querying time entries, projects, tasks, customers, and team data using natural language.
Track time in Clockify: time entries, projects, clients, tags and reports; start, stop and log time.
Manage Redbooth tasks, task lists, comments, tags and files from Claude and other AI assistants.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables time tracking and project management through the Clockify API. Supports starting/stopping timers, logging time entries, managing projects and tasks, and generating reports with natural language commands.2132 npmMIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to interact with the Toggl time tracking API to manage time entries, projects, and workspaces through natural language.22MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Toggl Track time entries, projects, and workspaces through natural language, supporting CRUD operations and past date time slots.1318 npm2MIT
- AlicenseNot gradedqualityCmaintenanceEnables to manage Toggl time entries, projects, tasks, and timers through natural language commands.MIT