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 MCP, CLI, and Lua Integration for AI Agents

Toggl integration docs for AI agents: MCP gateway setup, Toggl CLI commands, Lua API reference, credentials, and function schemas.

7 functions 6 read 1 write API token auth

Submit Toggl feedback View package source

Toggl for agents

Credentials can be configured manually in web or CLI hosts.

Use this integration from Lua code mode, the headless integrations CLI, or the KosmoKrator MCP gateway. The same package metadata powers all three surfaces.

Machine-Readable Metadata

integration_slug: toggl
route_slug: toggl
package: toggl
auth_strategy: api_token API token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true
supports_multi_account: true

Quick Links

Lua APIAgent-facing namespace and function reference. Toggl CLIHeadless setup and direct function calls. Toggl MCPMCP gateway setup for external clients. Submit feedbackReport missing tools, auth problems, wrong docs, or runtime issues. ContributeAdd tools or improve metadata in the integrations repo.

Toggl MCP Client Matrix

Use these pages when a specific agent client or framework needs copy-pasteable MCP setup for Toggl.

Claude Code Toggl MCP setup for Claude Code. Cursor Toggl MCP setup for Cursor. Codex Toggl MCP setup for Codex. OpenAI Agents Toggl MCP setup for OpenAI Agents SDK. Claude Agent SDK Toggl MCP setup for Claude Agent SDK. Vercel AI SDK Toggl MCP setup for Vercel AI SDK. LangChain Toggl MCP setup for LangChain. LangGraph Toggl MCP setup for LangGraph. CrewAI Toggl MCP setup for CrewAI. MCP clients Toggl MCP setup for Generic MCP Clients.

Toggl CLI Matrix

Use these pages for direct Toggl CLI workflows in scripts, CI, cron, and agent wrappers.

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

Function Catalog

Function	Type	Parameters	Description
`toggl.toggl_create_time_entry`	Write `write`	7	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 `read`	0	Get the authenticated Toggl user profile. Use this to verify your API token is working.
`toggl.toggl_get_project`	Read `read`	2	Get details for a single Toggl project by ID.
`toggl.toggl_get_time_entry`	Read `read`	1	Get details for a single Toggl time entry by ID.
`toggl.toggl_list_projects`	Read `read`	2	List projects in a Toggl workspace. Optionally filter for active projects only.
`toggl.toggl_list_time_entries`	Read `read`	2	List recent Toggl time entries. Optionally filter by date range.
`toggl.toggl_list_workspaces`	Read `read`	0	List all Toggl workspaces the authenticated user belongs to. Returns workspace IDs and names needed for other Toggl tools.