Can I use Kimai as a CLI?

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

Can I expose Kimai through MCP?

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

Where are Kimai credentials stored?

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

Can I deny write access for Kimai MCP tools?

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

productivity

Kimai MCP, CLI, and Lua Integration for AI Agents

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

7 functions 6 read 1 write Bearer token auth

Submit Kimai feedback View package source

Kimai 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: kimai
route_slug: kimai
package: kimai
auth_strategy: bearer_token Bearer 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. Kimai CLIHeadless setup and direct function calls. Kimai 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.

Kimai MCP Client Matrix

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

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

Kimai CLI Matrix

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

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

Function Catalog

Function	Type	Parameters	Description
`kimai.kimai_list_timesheets`	Read `read`	7	List time-tracking entries from Kimai. Supports filtering by user, project, date range, and state. Returns paginated results with timesheet details including duration, description, and associated project/activity.
`kimai.kimai_get_timesheet`	Read `read`	1	Get details of a specific timesheet entry from Kimai. Returns the full timesheet record including begin/end timestamps, duration, description, project, activity, and user information.
`kimai.kimai_create_timesheet`	Write `write`	5	Create a new time-tracking entry in Kimai. Requires a begin timestamp and at least a project ID. Optionally specify an end time, activity, and description to categorize the time entry.
`kimai.kimai_list_projects`	Read `read`	4	List projects from Kimai. Supports filtering by customer and visibility. Returns project details including name, customer, budget, and time budget information.
`kimai.kimai_get_project`	Read `read`	1	Get details of a specific project from Kimai. Returns the full project record including name, customer, comment, budget, time budget, and visibility status.
`kimai.kimai_list_customers`	Read `read`	3	List customers from Kimai. Supports filtering by visibility. Returns customer details including name, company, contact information, and associated project count.
`kimai.kimai_get_current_user`	Read `read`	0	Get the profile of the currently authenticated Kimai user. Returns user details including username, display name, email, timezone, and language preferences.