Kimai in Claude, ChatGPT und jedem MCP-Client. Für Ihr ganzes Team.
Zeiteinträge, Kunden, Projekte, Tätigkeiten, Benutzer, Teams, Rechnungen. Ein Token in Loopthink, ein Login pro Person, Rollen pro Tool und ein Audit-Eintrag für jeden Aufruf.
Kostenlos für 2 Connectors, ohne Karte · Pro 19 € · in der EU betrieben · 17 Lese-Tools, 3 Schreib-Tools standardmäßig aus
“Wie viele Stunden sind im Oktober in den Nordwind-Relaunch geflossen, nach Tätigkeit?”
Im Oktober wurden bisher 86,5 Stunden auf den Nordwind-Relaunch gebucht:
| Tätigkeit | Einträge | Stunden | Letzter Eintrag |
|---|---|---|---|
| Entwicklung | 31 | 58,0 | 23.10.2026 |
| Konzeption | 9 | 19,5 | 21.10.2026 |
| Abstimmung Kunde | 7 | 9,0 | 22.10.2026 |
- nur lesend
- maskiert
Ein Token rein, die Tools kommen raus.
Kimai ist die Open-Source-Zeiterfassung vieler Agenturen, Beratungen und IT-Dienstleister im DACH-Raum, auf dem eigenen Server oder in der Kimai Cloud: Zeiteinträge pro Kunde, Projekt und Tätigkeit, Budgets, Teams und Rechnungen. Die Zahlen sind alle da; eine Frage wie die nach dem Restbudget heißt trotzdem Auswertung, Filter und Tabelle.
Mit dem Kimai-Connector fragen Projektleitung, Controlling, Teamleitungen und alle, die Zeiten buchen, in Claude oder ChatGPT und bekommen die Antwort aus der laufenden Instanz. Loopthink hält einen API-Token eines Kimai-Benutzers, jede Person meldet sich mit ihrer eigenen Identität an, und jeder Aufruf wird unter ihrem Namen protokolliert.
Siebzehn Lese-Tools decken Zeiteinträge, laufende Timer, letzte Tätigkeiten, Kunden, Projekte, Tätigkeiten, Benutzer, Teams, Tags und Rechnungen ab. Drei Schreib-Tools, Anlegen, Ändern und Stoppen eines Zeiteintrags, bleiben aus, bis Sie sie für eine Rolle einschalten.
- Projektleitung
“Wie viele Stunden sind im Oktober in den Nordwind-Relaunch geflossen, nach Tätigkeit?”
Beantwortet von
list_timesheets - Controlling
“Wie hoch ist das Zeitbudget im Projekt Kraus & Partner, und wie viel ist verbraucht?”
Beantwortet von
get_project - Teamleitung
“Wer in meinem Team hat letzte Woche weniger als 30 Stunden gebucht?”
Beantwortet von
list_timesheets - Controlling
“Welche Kimai-Rechnungen aus dem September sind noch offen?”
Beantwortet von
list_invoices - Berater
“Läuft bei mir noch ein Timer?”
Beantwortet von
list_active_timesheets - Berater
“Buch gestern Nachmittag 2,5 Stunden auf Acme, Workshop-Vorbereitung.”
Beantwortet von
create_timesheet
Was der Kimai-Connector kann.
| Tool | Was es tut | Zugriff | Standard |
|---|---|---|---|
| ping | Checks that the Kimai URL and API token work. Returns {"message":"pong"}. | Lesen | An |
| get_version | Returns the Kimai release of this installation (version, versionId, copyright). Useful to explain why a feature or field is missing on an older release. | Lesen | An |
| get_current_user | Returns the user behind the API token: id, username, alias, language, timezone, roles, teams. Use the id as user in list_timesheets. | Lesen | An |
| list_timesheets | Lists timesheet records (time entries), newest first by default. Without user it returns only the token user's records; pass user=all (needs the view_other_timesheet permission)… | Lesen | An |
| get_timesheet | Reads one timesheet record by id, with begin, end, duration, rates, project, activity, user, tags, description and meta fields. | Lesen | An |
| list_active_timesheets | Lists the token user's currently running timesheet records (timers that have a begin but no end yet), with project, activity and customer expanded. Empty list when nothing is ru… | Lesen | An |
| list_recent_timesheets | Lists the token user's recent working combinations: the latest record per unique customer, project and activity. Good for suggesting what to book next. | Lesen | An |
| list_customers | Lists customers with id, name, number, currency, visible and color. Use it to find a customer id by name. | Lesen | An |
| get_customer | Reads one customer by id with full details: contact, address, email, phone, VAT id, budgets, time budget, meta fields and teams. | Lesen | An |
| list_projects | Lists projects with id, name, customer, order number, start and end. By default only projects running today; pass ignore_dates=1 for all. | Lesen | An |
| get_project | Reads one project by id with customer, order number and date, start and end, budgets, time budget, global-activities flag and meta fields. | Lesen | An |
| list_activities | Lists activities (the kind of work, e.g. Development, Meeting). | Lesen | An |
| list_users | Lists users with id, username, alias, enabled and color. Needs the view_user permission. | Lesen | An |
| list_teams | Lists the teams the token user may see, with id, name and color. Teams decide who sees which customers, projects and activities. | Lesen | An |
| list_tags | Lists tag names used on timesheets. Use the names in the tags filter of list_timesheets. | Lesen | An |
| list_invoices | Lists invoices created in Kimai with number, customer, created date, total, tax, currency, status and due date. Needs the view_invoice permission. | Lesen | An |
| get_invoice | Reads one invoice by id: number, customer, user, created date, total, tax, VAT, currency, status, due days, payment date and comment. | Lesen | An |
| create_timesheet | Creates a timesheet record. Without end the record keeps running as a timer; without begin it starts now. | Schreiben | Aus |
| update_timesheet | Changes a timesheet record. Send only the fields to change. | Schreiben | Aus |
| stop_timesheet | Stops a running timesheet record (sets end to now). Get the id from list_active_timesheets. | Schreiben | Aus |
Schreib-Tools sind für jede Rolle aus, bis Sie sie einschalten, ein Tool für eine Rolle. Die Namen und Beschreibungen sind das, was das Modell sieht, deshalb bleiben sie englisch; es bekommt außerdem die vollständige Parameterbeschreibung jedes Tools.
So kommen Sie an den Kimai-Token.
Fünf Minuten, einmalig. Niemand in Ihrem Team sieht ihn je.
- 1
In Kimai als der Benutzer anmelden, in dessen Namen Loopthink handeln soll.
- 2
Das persönliche Benutzermenü (oben rechts) öffnen und „API-Zugang“ wählen.
- 3
Auf „Erstellen“ klicken, dem Token einen Namen geben (z. B. „Loopthink“) und optional ein Ablaufdatum setzen.
- 4
Den Token sofort kopieren: Er wird nur einmal angezeigt. Hier die Kimai-URL (ohne /api) eintragen.
- 5
In Loopthink fügen Sie Kimai aus dem Katalog hinzu und fügen den Token ein. Außerdem fragt der Connector nach kimai url. Eine Minute später sieht Ihr Team die Tools.
Braucht Kimai 2.14.0 oder neuer (April 2024), die erste Version mit API-Token im Header „Authorization: Bearer“. Die älteren API-Passwörter (X-AUTH-USER / X-AUTH-TOKEN) wurden damals abgekündigt und nach Q2 2026 entfernt, sie werden hier nicht unterstützt. Der Token handelt als sein Benutzer: Zeiteinträge anderer (user=all), die Benutzerliste, Teams und Rechnungen brauchen eine Rolle mit diesen Rechten (z. B. Teamleiter oder Admin). create_timesheet bucht für den Benutzer des Tokens, außer seine Rolle darf Zeiten für andere anlegen.
Was wir in Kimai zu maskieren empfehlen.
Zeiteinträge sind personenbezogen: wer wann wie lange woran gearbeitet hat, oft mit Beschreibung. Kunden enthalten Ansprechpartner, Adressen, Telefonnummern und USt-IdNr. Die vorgeschlagenen Felder maskieren Benutzernamen, Aliase, E-Mail-Adressen, Kontaktdaten und Kommentare für Rollen, die nur Stunden pro Projekt brauchen; Teamleitungen, die die Zeiten freigeben, bekommen eine Rolle ohne diese Regel.
- username
- alias
- title
- initials
- accountNumber
- contact
- address
- phone
- mobile
- fax
- vatId
- comment
Kimai und Loopthink
- Welche Kimai-Version und welchen Benutzer braucht der Connector?
- Kimai 2.14.0 oder neuer, die erste Version mit API-Token. Der Token hat keine Scopes und handelt mit der Rolle seines Benutzers: Zeiteinträge anderer, die Benutzerliste, Teams und Rechnungen brauchen eine Rolle mit diesen Rechten, zum Beispiel Teamleiter oder Admin. Ein normaler Benutzer sieht nur seine eigenen Zeiten.
- Funktioniert der Connector mit den alten API-Passwörtern?
- Nein. Die älteren API-Passwörter wurden mit Kimai 2.14 abgekündigt und nach Q2 2026 entfernt. Legen Sie stattdessen in Ihrem Benutzermenü unter API-Zugang einen API-Token an.
- In wessen Namen bucht die KI Zeiten?
- create_timesheet bucht für den Benutzer des Tokens, außer dessen Rolle darf Zeiten für andere anlegen. Die Schreib-Tools sind standardmäßig aus; jeder Aufruf wird mit dem Namen der Person protokolliert, die gefragt hat.
- Wir hosten Kimai selbst. Erreicht der Connector die Instanz?
- Kimai Cloud funktioniert direkt. Eine selbst gehostete Instanz muss aus dem Internet per HTTPS erreichbar sein. Ist sie nur im eigenen Netz erreichbar, sagen Sie uns Bescheid, dann schauen wir es uns mit Ihnen an.
- Braucht jedes Teammitglied einen eigenen Kimai-Account?
- Nein. Loopthink hält einen Schlüssel oder Token für Kimai. Ihre Leute melden sich mit ihrer eigenen Identität bei Loopthink an, und jeder Aufruf an Kimai wird unter ihrem Namen protokolliert. Die Lizenzen in Kimai bleiben, wie sie heute sind.
- Wo liegt der Kimai-Schlüssel?
- In Loopthink, verschlüsselt, in der EU. Er erreicht weder den KI-Client noch die Personen, die den Connector nutzen. Rotieren Sie ihn in Kimai, wann immer Sie wollen, und fügen Sie den neuen einmal ein.
- Kann jemand aus dem Chat heraus in Kimai schreiben?
- Nur, wenn Sie es einschalten. Schreibaktionen sind eine eigene Zeile in der Rechtematrix und für jede Rolle standardmäßig aus. Braucht eine Rolle ein Schreib-Tool, geben Sie genau dieses eine Tool genau dieser Rolle frei.
- Was sieht das Modell?
- Das Ergebnis des Tool-Aufrufs, nach der Maskierung. Felder, die Sie als personenbezogen markieren, etwa E-Mail-Adressen, Namen oder Kartendaten, werden maskiert, bevor die Antwort zu den KI-Client reist. Das Modell bekommt die Zahlen, nicht die Menschen.
- Was kostet es?
- Kostenlos für eine Person und zwei Connectors, ohne Karte. Pro kostet 19 € im Monat für bis zu fünf Personen und jeden Connector auf dieser Seite, mit Rollen, feldgenauer Maskierung und 30 Tagen Audit-Log. Team kostet 49 € für zehn Personen und bringt Ihre eigenen REST-APIs und SQL-Datenbanken, Ihre eigene Domain und Ihren eigenen Identity Provider dazu. Kein Gespräch nötig.
Hängen Sie fest, oder fehlt ein Tool? Ein Mensch, der diesen Connector kennt, antwortet innerhalb eines Arbeitstags.
