
Toggl Mcp
Connects Claude directly to the Toggl Track API v9 so you can query time entries, start and stop timers, and pull project summaries without leaving your conversation. You get seven tools covering the essentials: checking what's running now, grabbing recent entries, summarizing hours by project across date ranges, and controlling timers with natural language. Useful when you're already working in Claude and want to log time, review your week, or answer "how long did I spend on that?" without context switching to Toggl's web interface. Requires an API token from your profile settings and stays within free tier rate limits through batched requests.
- tools
- 7
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- May 27, 2026
Tools
7 toolsPublic tool metadata for what this MCP can expose to an agent.
get_current_timerShows the currently running time entry
Shows the currently running time entry
No parameter schema in public metadata yet.
get_recent_entriesTime entries for the past N days (default 7)
Time entries for the past N days (default 7)
No parameter schema in public metadata yet.
get_projectsLists all your projects
Lists all your projects
No parameter schema in public metadata yet.
get_summaryTotal time by project for a date range
Total time by project for a date range
No parameter schema in public metadata yet.
start_timerStarts a new time entry
Starts a new time entry
No parameter schema in public metadata yet.
stop_timerStops the current timer
Stops the current timer
No parameter schema in public metadata yet.
get_profileYour Toggl profile and workspaces
Your Toggl profile and workspaces
No parameter schema in public metadata yet.
Sponsors
Configuration
TOGGL_API_TOKEN*secretYour Toggl Track API token. Get it from https://track.toggl.com/profile — scroll to the bottom and click 'Click to reveal'
Readme
toggl-mcp
A Model Context Protocol (MCP) server that gives Claude access to your Toggl Track time tracking data.
Ask Claude things like:
- "What am I tracking right now?"
- "How much time did I spend on each project this week?"
- "Start a timer for writing documentation on the Blog project"
- "Stop my timer"
- "What did I work on yesterday?"
Tools
| Tool | What it does |
|---|---|
get_current_timer | Shows the currently running time entry |
get_recent_entries | Time entries for the past N days (default 7) |
get_projects | Lists all your projects |
get_summary | Total time by project for a date range |
start_timer | Starts a new time entry |
stop_timer | Stops the current timer |
get_profile | Your Toggl profile and workspaces |
Setup
1. Get your API token
- Go to https://track.toggl.com/profile
- Scroll to the bottom
- Click "Click to reveal" under API Token
- Copy the token
2. Install
npm install -g toggl-mcp
Find the installed path:
which toggl-mcp
3. Add to Claude Desktop
Details
- Repository
- github.com/souravpn/toggl-mcp
- Category
- Data & Analytics
- Package
@souravpn/toggl-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active