davidmosna/toggl-mcp-server
3.2
If you are the rightful owner of toggl-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.
This is a Toggl MCP Server designed for integrating Toggl Track time tracking with Claude Code via Docker Desktop.
Tools
4
Resources
0
Prompts
0
Toggl MCP Server
MCP server for Toggl Track time tracking integration with Claude Code via Docker Desktop.
Features
| Tool | Description |
|---|---|
get_current_timer | Get currently running timer |
get_time_entries | Get time entries (with optional date filtering) |
start_timer | Start timer with description, project, tags, billable status |
stop_timer | Stop current or specific timer |
Quick Setup
1. Get Credentials
- API Token: https://track.toggl.com/profile
- Workspace ID: Check URL at https://track.toggl.com/timer/`WORKSPACE_ID`
2. Build & Configure
docker build -t toggl-mcp-server:latest .
cd mcp-config
./setup.sh YOUR_API_TOKEN YOUR_WORKSPACE_ID
3. Enable in Docker Desktop
Settings → MCP → Enable "Claude Code" → Apply & Restart
4. Add in Claude Code
mcp-add toggl
Usage Examples
"What timer is currently running?"
"Start a timer for 'Writing documentation'"
"Show me my time entries from today"
"Stop the current timer"
Manual Setup
See for detailed manual setup instructions.
Development
npm install
npm run build # Compile TypeScript
npm run watch # Watch mode
Troubleshooting
| Issue | Solution |
|---|---|
| Server not found | Check docker mcp list, verify image exists |
| Auth errors | Verify credentials: curl -u TOKEN:api_token https://api.track.toggl.com/api/v9/me |
| Image issues | Rebuild: docker build -t toggl-mcp-server:latest . |
License
MIT