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 mcp-config/README.md 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