productivity
Toggl Track CLI for Headless Automation
Use the Toggl Track CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.
7 functions 6 read 1 write API token auth
Toggl Track CLI for Headless Automation
Use KosmoKrator as a non-interactive integration runtime for local automations and wrappers.
Use headless automation when another tool needs a stable local command surface. The Toggl Track CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.
Command Shape
# Toggl Track CLI for Headless Automation
kosmokrator integrations:configure toggl-track --set api_token="$TOGGL_TRACK_API_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call toggl-track.toggl_list_time_entries '{"start_date":"example_start_date","end_date":"example_end_date","workspace_id":1,"project_id":1,"limit":1}' --json Discovery Before Execution
Agents and scripts can inspect Toggl Track docs and schemas before choosing a function.
kosmo integrations:docs toggl-track --json
kosmo integrations:docs toggl-track.toggl_list_time_entries --json
kosmo integrations:schema toggl-track.toggl_list_time_entries --json
kosmo integrations:search "Toggl Track" --json
kosmo integrations:list --json Useful Toggl Track CLI Functions
| Function | Type | Parameters | Description |
|---|---|---|---|
toggl-track.toggl_list_time_entries | Read | start_date, end_date, workspace_id, project_id, limit | List time entries from Toggl Track. Filter by date range, workspace, or project. Returns recent time entries by default. |
toggl-track.toggl_get_time_entry | Read | id | Get detailed information about a specific Toggl Track time entry by its ID. |
toggl-track.toggl_create_time_entry | Write | workspace_id, description, duration, start, pid, tags, billable, created_with | Create a new time entry in Toggl Track. Provide a description, workspace, start time, and duration. Optionally assign to a project, add tags, or mark as billable. |
toggl-track.toggl_list_projects | Read | active, workspace_id | List projects from Toggl Track. Optionally filter by workspace or active status. |
toggl-track.toggl_get_project | Read | id | Get detailed information about a specific Toggl Track project by its ID. |
toggl-track.toggl_list_workspaces | Read | none | List all Toggl Track workspaces accessible to the authenticated user. Returns workspace IDs and names needed for other operations. |
toggl-track.toggl_get_current_user | Read | none | Get the authenticated Toggl Track user profile, including email, name, default workspace, and time zone. |
Automation Notes
- Use
--jsonfor machine-readable output. - Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
- Configure read/write policy before unattended runs; use
--forceonly for trusted automation. - Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.