A Claude Code plugin that connects to Toggl Track so you can log and review time entries using natural language.
- Log time — "Log 2h on the AVA project / Login Bug task yesterday"
- Query entries — "What did I track this week?" / "Show Cover AIT entries for May"
- Get summaries — "How much time did I spend on Cover AIT this month?"
- Check running timer — "Is anything currently running?"
- Start / stop timers — "Start tracking Login Bug" / "Stop the timer"
- Edit or delete entries — "Change yesterday's entry to 2h"
1. Add the marketplace and install the plugin:
One step (Claude Code 2.1.275+):
/plugin install toggl --marketplace run-as-root/toggl-claude-plugin
Or:
claude plugin marketplace add https://github.com/run-as-root/toggl-claude-plugin
claude plugin install toggl2. Add your Toggl API token — enter it when Claude Code prompts for plugin settings (stored securely), or use the credentials file: (found at toggl.com/profile):
mkdir -p ~/.claude/toggl
echo "YOUR_API_TOKEN" > ~/.claude/toggl/credentials3. Restart Claude Code.
Just talk to Claude naturally — the skill activates automatically:
"Log 90 min on Cover Main / development today"
"What did I track last week?"
"How much time on the run_as_root project in May?"
"Log 8h public holiday on Friday"
Claude resolves project and task names automatically before logging.
Note: If your Toggl workspace requires both a project and task on every entry (workspace-level setting), Claude will always ask for both when logging.
| Tool | Purpose |
|---|---|
toggl_get_me |
Get user info and workspace ID |
toggl_list_projects |
List all active projects |
toggl_list_tasks |
List tasks inside a project |
toggl_list_time_entries |
Query entries by date range / project / task |
toggl_get_summary |
Aggregated time totals by project and task |
toggl_create_time_entry |
Log a completed time entry |
toggl_get_current_timer |
Check what's currently running |
toggl_start_timer |
Start a running timer |
toggl_stop_timer |
Stop the running timer |
toggl_update_time_entry |
Edit an existing entry |
toggl_delete_time_entry |
Delete an entry |
toggl_list_tags |
List workspace tags |
claude plugin update toggl@toggl- Claude Code
- Node.js 18+
- Toggl Track account