Can I use Clockify as a CLI?

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

Can I expose Clockify through MCP?

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

Where are Clockify credentials stored?

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

Can I deny write access for Clockify MCP tools?

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

productivity

Clockify MCP, CLI, and Lua Integration for AI Agents

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

12 functions 8 read 4 write API key auth

Submit Clockify feedback View package source

Clockify 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: clockify
route_slug: clockify
package: clockify
auth_strategy: api_key API key
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. Clockify CLIHeadless setup and direct function calls. Clockify 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.

Clockify MCP Client Matrix

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

Clockify CLI Matrix

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

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

Function Catalog

Function	Type	Parameters	Description
`clockify.clockify_list_workspaces`	Read `read`	0	List all Clockify workspaces the authenticated user belongs to. Returns workspace IDs and names needed for other Clockify tools.
`clockify.clockify_get_workspace`	Read `read`	1	Get details for a single Clockify workspace by ID.
`clockify.clockify_list_projects`	Read `read`	4	List projects in a Clockify workspace. Optionally filter by name and paginate results.
`clockify.clockify_get_project`	Read `read`	2	Get details for a single Clockify project by ID.
`clockify.clockify_create_project`	Write `write`	4	Create a new project in a Clockify workspace.
`clockify.clockify_list_time_entries`	Read `read`	6	List time entries in a Clockify workspace. Optionally filter by date range or project.
`clockify.clockify_get_time_entry`	Read `read`	2	Get details for a single Clockify time entry by ID.
`clockify.clockify_create_time_entry`	Write `write`	5	Create a new time entry in a Clockify workspace. Provide start/end times, a description, and optionally a project.
`clockify.clockify_update_time_entry`	Write `write`	6	Update an existing Clockify time entry. Provide the fields you want to change.
`clockify.clockify_delete_time_entry`	Write `write`	2	Delete a Clockify time entry. This action cannot be undone.
`clockify.clockify_list_tasks`	Read `read`	4	List tasks for a Clockify project.
`clockify.clockify_get_current_user`	Read `read`	0	Get the authenticated Clockify user profile. Use this to verify your API key is working.