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.

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.

Agent Surfaces

Kimai CLIHeadless setup, JSON output, direct function calls. Kimai MCPExpose selected tools to local MCP clients. Kimai LuaAgent-facing namespace and Lua reference. FeedbackReport missing tools, auth issues, or bad metadata.

Machine-Readable Metadata

integration_slug: kimai
route_slug: kimai
package: kimai
auth_strategy: bearer_token
cli_setup_supported: true
cli_runtime_supported: true
mcp_gateway_supported: true
lua_supported: true

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.