Can I use Toggl as a CLI?

Yes. KosmoKrator exposes a Toggl CLI through kosmo integrations:call and the provider shortcut command. Commands can return JSON for scripts, CI, and coding agents.

Can I expose Toggl through MCP?

Yes. The KosmoKrator MCP gateway can expose selected Toggl tools to clients such as Claude Code, Cursor, Codex, and other MCP-compatible tools.

Where are Toggl credentials stored?

Toggl credentials are configured in KosmoKrator's local integration settings and reused by CLI, Lua, and MCP gateway surfaces.

Can I deny write access for Toggl MCP tools?

Yes. Start the gateway with --write=deny for read-only clients, or use ask/allow only for trusted workspaces.

productivity

Toggl CLI for Headless Automation

Use the Toggl CLI for headless automation with headless JSON commands, schema discovery, credentials, and permission controls.

7 functions 6 read 1 write API token auth

Submit Toggl feedback View package source

Toggl 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 CLI uses the same integration registry as the TUI, Lua runtime, and MCP gateway, but returns predictable command output for automation.

Command Shape

# Toggl CLI for Headless Automation
kosmokrator integrations:configure toggl --set api_token="$TOGGL_API_TOKEN" --enable --read allow --write ask --json
kosmo integrations:call toggl.toggl_create_time_entry '{"workspace_id":"example_workspace_id","description":"example_description","start":"example_start","stop":"example_stop","duration":1,"project_id":"example_project_id","tags":"example_tags"}' --json

Discovery Before Execution

Agents and scripts can inspect Toggl docs and schemas before choosing a function.

kosmo integrations:docs toggl --json
kosmo integrations:docs toggl.toggl_create_time_entry --json
kosmo integrations:schema toggl.toggl_create_time_entry --json
kosmo integrations:search "Toggl" --json
kosmo integrations:list --json

Useful Toggl CLI Functions

Function	Type	Parameters	Description
`toggl.toggl_create_time_entry`	Write	workspace_id, description, start, stop, duration, project_id, tags	Create a new time entry in a Toggl workspace. Provide a description, start time, and optionally a project and stop time.
`toggl.toggl_get_current_user`	Read	none	Get the authenticated Toggl user profile. Use this to verify your API token is working.
`toggl.toggl_get_project`	Read	workspace_id, project_id	Get details for a single Toggl project by ID.
`toggl.toggl_get_time_entry`	Read	time_entry_id	Get details for a single Toggl time entry by ID.
`toggl.toggl_list_projects`	Read	workspace_id, active	List projects in a Toggl workspace. Optionally filter for active projects only.
`toggl.toggl_list_time_entries`	Read	start_date, end_date	List recent Toggl time entries. Optionally filter by date range.
`toggl.toggl_list_workspaces`	Read	none	List all Toggl workspaces the authenticated user belongs to. Returns workspace IDs and names needed for other Toggl tools.

Automation Notes

Use --json for machine-readable output.
Keep credentials out of argv by using environment variables or stored KosmoKrator configuration.
Configure read/write policy before unattended runs; use --force only for trusted automation.
Use the MCP gateway instead when the agent needs dynamic tool discovery inside a conversation.

Related Toggl CLI Pages

CI Toggl CLI for CI. Cron Jobs Toggl CLI for cron jobs. Shell Scripts Toggl CLI for shell scripts. Coding Agents Toggl CLI for coding agents.