kimai-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| KIMAI_BASE_URL | Yes | Base URL of your Kimai instance without a trailing slash, e.g. https://your-instance.example.com | |
| KIMAI_API_TOKEN | Yes | Kimai API token (bearer token) | |
| KIMAI_TIMEOUT_MS | No | HTTP request timeout in milliseconds | 30000 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| kimai_get_server_infoA | Read Kimai API status, version, plugin, and timesheet configuration endpoints. This tool is read-only. |
| kimai_get_current_userA | Read the current Kimai user from /api/users/me. This tool is read-only. |
| kimai_list_usersB | List Kimai users visible to the API token from /api/users. This tool is read-only. |
| kimai_get_userB | Read one Kimai user from /api/users/. This tool is read-only. |
| kimai_list_customersA | List customers visible to the Kimai API token from /api/customers. This tool is read-only. |
| kimai_get_customerA | Read one Kimai customer from /api/customers/. This tool is read-only. |
| kimai_list_projectsA | List projects visible to the Kimai API token from /api/projects, optionally filtered by customer. This tool is read-only. |
| kimai_get_projectA | Read one Kimai project from /api/projects/. This tool is read-only. |
| kimai_list_activitiesA | List activities visible to the Kimai API token from /api/activities, optionally filtered by project. This tool is read-only. |
| kimai_get_activityA | Read one Kimai activity from /api/activities/. This tool is read-only. |
| kimai_list_tagsB | List Kimai tags from /api/tags/find. This tool is read-only. |
| kimai_list_timesheetsA | List Kimai timesheet entries from /api/timesheets with optional user, customer, project, activity, date, tag, exported, and active filters. This tool is read-only. |
| kimai_get_timesheetA | Read one Kimai timesheet entry from /api/timesheets/. This tool is read-only. |
| kimai_list_active_timesheetsA | List currently running Kimai timesheet entries from /api/timesheets/active. This tool is read-only. |
| kimai_list_recent_timesheetsB | List recent Kimai timesheet entries from /api/timesheets/recent. This tool is read-only. |
| kimai_create_timesheetA | Create a Kimai timesheet record. Sensitive edit: call only after explicit human authorization. The request and created record are saved to a temp backup file. |
| kimai_update_timesheetA | Update a Kimai timesheet record. Sensitive edit: call only after explicit human authorization. The existing record is saved to a temp backup file before the edit. |
| kimai_stop_timesheetA | Stop an active Kimai timesheet. Sensitive edit: call only after explicit human authorization. The existing record is saved to a temp backup file before stopping. |
| kimai_restart_timesheetA | Restart a stopped Kimai timesheet. Sensitive edit: call only after explicit human authorization. The existing record is saved to a temp backup file before restarting. |
| kimai_duplicate_timesheetA | Duplicate an existing Kimai timesheet. Sensitive edit: call only after explicit human authorization. The source and created record are saved to a temp backup file. |
| kimai_list_teamsA | List Kimai teams from /api/teams. This tool is read-only. |
| kimai_get_teamA | Read one Kimai team from /api/teams/. This tool is read-only. |
| kimai_list_invoicesB | List Kimai invoices from /api/invoices. This tool is read-only. |
| kimai_get_invoiceA | Read one Kimai invoice from /api/invoices/. This tool is read-only. |
| kimai_list_expensesB | List expenses from /api/expenses when the Kimai expenses feature/plugin is available. This tool is read-only. |
| kimai_get_expenseA | Read one expense from /api/expenses/ when the Kimai expenses feature/plugin is available. This tool is read-only. |
| kimai_list_tasksB | List tasks from /api/tasks when the Kimai tasks feature/plugin is available. This tool is read-only. |
| kimai_get_taskA | Read one task from /api/tasks/ when the Kimai tasks feature/plugin is available. This tool is read-only. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 28 tools
Every tool targets a distinct resource and operation, with clear naming like kimai_list_users vs kimai_get_user. No two tools overlap in purpose, ensuring agents can easily select the correct tool.
All tools follow a consistent kimai_{verb}_{noun} pattern in snake_case, such as kimai_list_projects, kimai_get_project, kimai_create_timesheet. This uniformity makes the tool surface predictable.
With 28 tools covering multiple resource types (users, customers, projects, activities, timesheets, invoices, teams, tasks, expenses), the count is slightly high but still well-scoped for a comprehensive Kimai API wrapper. It avoids excessive granularity.
The tool set provides robust read-only access and full lifecycle operations for timesheets, but lacks create/update/delete for other entities like customers, projects, and activities. This leaves notable gaps for full CRUD management.