A complete API integration for Kimai to manage timesheets, projects, customers, and invoices directly through your AI agent.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install kimai-time-tracking
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install kimai-time-tracking using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Kimai Time Tracking?
The Kimai Time Tracking skill provides a robust bridge between your AI agent and the Kimai open-source time-tracking software. It enables developers and teams to manage the entire lifecycle of time tracking—from starting active timers to generating complex reports and invoices—using simple commands. By leveraging Openclaw Skills, you can automate administrative overhead and ensure accurate logging across customers, projects, and activities without leaving your development environment.
This skill is designed for high-efficiency environments where precision in zeiterfassung is critical. Whether you are managing a solo freelance operation or a large development team, the integration ensures that your timesheet data is always accessible, searchable, and ready for export. It streamlines the connection to Kimai 2.x instances, providing a professional-grade interface for all time-related operations.
Kimai Time Tracking Use Cases
- Starting, stopping, or restarting active timers for specific projects and activities.
- Generating and exporting timesheet reports to CSV for payroll or client billing.
- Automating the creation and management of new customers, projects, and activities hierarchy.
- Managing team memberships and granular access permissions for various system resources.
- Querying system status, versions, and configurations to ensure seamless API connectivity.
How Kimai Time Tracking Works
- The skill initializes a secure connection to your Kimai instance using the KIMAI_BASE_URL and KIMAI_API_TOKEN environment variables.
- Users interact through the kimai_cli.py script, which translates user intent into precise REST API requests.
- For time tracking, the skill can start timers with custom descriptions and tags, or manage manual timesheet entries.
- The skill logic handles complex operations such as auto-pagination for large lists and filtering by date ranges or billable status.
- For destructive actions like deleting a customer, the skill implements a safety layer that requires explicit user confirmation before execution.
- Data is returned in the user's preferred format, including machine-parseable JSON or human-readable tables.
Kimai Time Tracking Setup
To get started with this skill in your Openclaw Skills environment, configure your access credentials:
# Set the required connection details
export KIMAI_BASE_URL="https://your-kimai-instance.com"
export KIMAI_API_TOKEN="your-bearer-token"
# Optional: Define a specific workspace for exports
export KIMAI_WORKSPACE="~/.openclaw/workspace/kimai"
# Verify connectivity with a system ping
./scripts/kimai_cli.py system ping
Kimai Time Tracking Data Schema & Taxonomy
The skill organizes data according to the Kimai API schema, ensuring compatibility with standard reporting tools. Below is the primary data taxonomy:
| Entity | Key Attributes | Purpose |
|---|---|---|
| Timesheets | ID, Start/End, Project, Activity | Primary records for time tracking and active timers. |
| Customers | Name, Currency, Timezone | Top-level entities for organizational billing. |
| Projects | Name, Customer ID, Budget | Specific work streams nested under customers. |
| Activities | Name, Project ID | Task-level categorization for granular tracking. |
| Teams | Name, Members, Permissions | Access control groups for resource management. |
| Invoices | Status, Date, Customer | Financial records derived from exported timesheets. |
Kimai Time Tracking Advanced Features
- Auto-pagination support for handling large datasets without manual page requests.
- Cascade deletion logic with safety previews for customers, projects, and activities.
- Granular rate management allowing for custom billing rates at the customer, project, or activity level.
- Multi-format output support including JSON for automation and CSV for spreadsheet integration.
- Support for custom metadata fields (meta-tags) to store unique project or customer identifiers.
- Dry-run capabilities to simulate API calls before performing actual data modifications.
SKILL.md
Loading
Related Openclaw Skills
Coda API Skill
A comprehensive Python-based tool for managing Coda documents, tables, rows, and automations via the REST API v1.
Coda Packs Management
A specialized tool for managing Coda Pack shells and metadata through the official Coda REST API v1.
ohmytoken
A real-time AI spending tracker that visualizes LLM token consumption as interactive, customizable pixel art bead boards.
Douyin Cover Builder
An advanced AI creative assistant that generates high-conversion thumbnail prompts and design briefs tailored for Douyin content creators.
Open WebUI API Integration
A comprehensive API integration for managing LLMs, RAG workflows, and Ollama operations through an Open WebUI instance.
Game Light Tracker
A smart home automation skill that changes Philips Hue light colors in real-time based on live sports score leads.
Featured*
