Automate time tracking workflows in Toggl Track -- create time entries, manage projects, clients, tags, and workspaces through natural language commands.
SKILL.md
Toggl Automation
Automate your Toggl Track time tracking operations directly from Claude Code. Log time, manage projects and clients, organize with tags, and control workspaces -- all without leaving your terminal.
Show me all tags in workspace 123456 and the workspace preferences
TOGGL_GET_TAGS requires workspace_id; returns tag IDs and names
TOGGL_GET_WORKSPACE_PREFERENCES requires workspace_id; returns pricing plan and display settings
5. Workspace Discovery
List all workspaces the authenticated user belongs to.
Tool:TOGGL_GET_USER_WORKSPACES
What Toggl workspaces do I have access to?
No parameters required
Returns all workspaces with IDs, names, and metadata
Use this first to discover workspace IDs for other operations
6. User Project Visibility
List projects visible to the authenticated user.
Tool:TOGGL_GET_USER_PROJECTS
Show me all projects I can see across my workspaces
Returns projects the authenticated user has access to
Use alongside TOGGL_GET_PROJECTS for workspace-scoped views
Known Pitfalls
Tags use names, not IDs:TOGGL_CREATE_TIME_ENTRY accepts tag names as strings in the tags array, unlike many APIs that use IDs. Use TOGGL_GET_TAGS to verify available tag names.
created_with is required: Every time entry must include created_with (e.g., "api_client"). Missing this field causes silent failures.
Duration is in seconds: The duration parameter on time entries is in seconds, not hours. 1 hour = 3600 seconds.
since timestamp restriction: The since filter on TOGGL_GET_PROJECTS only allows timestamps within the last 3 months. Older queries will be rejected.
Premium features gated: Custom colors, templates, fixed fees, and hourly rates on projects require a premium Toggl plan. Non-premium accounts will get errors when using these fields.
Workspace ID required everywhere: Nearly all Toggl tools require workspace_id. Always call TOGGL_GET_USER_WORKSPACES first to resolve it.
Quick Reference
Tool Slug
Description
TOGGL_CREATE_TIME_ENTRY
Create a time entry or running timer (requires workspace_id, created_with, start)
TOGGL_PATCH_STOP_TIME_ENTRY
Stop a running time entry (requires workspace_id, time_entry_id)
TOGGL_GET_PROJECTS
List projects in a workspace with pagination
TOGGL_GET_PROJECT_DETAILS
Get details for a specific project
TOGGL_CREATE_PROJECT
Create a new project (requires workspace_id, name)
TOGGL_GET_LIST_CLIENTS
List clients with status/name filters (requires workspace_id)
TOGGL_CREATE_CLIENT
Create a new client (requires workspace_id, name)
TOGGL_GET_TAGS
List all tags in a workspace (requires workspace_id)
