# Kimai

Kategori: Projektledning · Tidrapportering

Tidrapportering för team: kunder, projekt och aktiviteter, veckogrid, kalender, rapporter och fakturaunderlag – självhostad i PHP.

- Officiell webbplats: https://www.kimai.org/
- Infraverket: https://infraverket.eu/programvara/kimai/

## Öppenhet och driftsättning
Licens: AGPL-3.0 (GNU Affero General Public License v3.0) (AGPL-3.0)
Öppen källkod: Ja
Installationsmetod: Container
Plattformar: Linux, containers
Krävd databas: MariaDB eller MySQL. Databasanslutningen anges i DATABASE_URL, och serverversionen måste stå i samma sträng.
Viktiga beroenden: En databas utöver applikationscontainern. E-postutskick kräver en SMTP-server om påminnelser och inbjudningar ska fungera, och fakturor kräver att en fakturamall installeras som tillägg.

## API och integrationer
Status: Finns (Uppgivet)
Typer: REST API
Dokumentation: https://www.kimai.org/documentation/api/
Anmärkning: REST-API med samma resurser som gränssnittet: kunder, projekt, aktiviteter, tidposter, användare, team och fakturor. Autentiseringen sker med en API-token per användare i Authorization-huvudet, och varje installation publicerar sin egen OpenAPI-dokumentation på /api/doc. I labbet skapades kunder, projekt, aktiviteter och 43 tidposter helt över API:t.

## MCP och AI-agentintegration
Roll: MCP-server; Ursprung: Tredjepart; Status: Finns
Dokumentation: https://github.com/glazperle/kimai_mcp
Server: [kimai-mcp](https://github.com/glazperle/kimai_mcp) — underhålls av glazperle (community) — ej-verifierat — MIT, publicerad på PyPI, senaste push 28 oktober 2026. Använder Kimais API-token och fungerar mot vilken Kimai-installation som helst.
Anmärkning: Det finns ingen MCP-server från Kimai självt, men väl flera communityprojekt som lägger ett MCP-lager ovanpå REST-API:t. Det största publiceras som Python-paket och täcker tidposter, projekt, aktiviteter, kunder och frånvaro.

## Tekniska resurser
- [Installationsguide](https://www.kimai.org/documentation/installation.html)
- [API-dokumentation](https://www.kimai.org/documentation/api/)
- [MCP-dokumentation](https://github.com/glazperle/kimai_mcp)
- [Container-registry](https://hub.docker.com/r/kimai/kimai2)
- [GitHub – kimai/kimai (AGPL-3.0)](https://github.com/kimai/kimai)

## Viktiga tekniska anmärkningar
Hårdvarukrav: Litet: i labbet räckte en applikationscontainer och en databaskontainer på en delad vCPU för tre användare och ett drygt fyrtiotal tidposter. Kravet styrs av antalet användare och rapportvolym, inte av antalet projekt.
Säkerhetsförutsättningar: Applikationen ska stå bakom TLS med TRUSTED_PROXIES satt så att den känner igen proxyn – annars skickar den omdirigeringar till http. APP_SECRET ska vara lång och unik, API-token hanteras som lösenord, och databasen ska säkerhetskopieras eftersom all rapporterad tid ligger där.

## Källhänvisning
- Infraverket: https://infraverket.eu/programvara/kimai/
- Senast faktagranskad: 2026-11-03
- Primärkällor:
  - [GitHub – kimai/kimai](https://github.com/kimai/kimai)
  - [Kimai – LICENSE (AGPL-3.0)](https://raw.githubusercontent.com/kimai/kimai/main/LICENSE)
  - [Kimai – om projektet och historiken](https://www.kimai.org/about/)
  - [Kimai – installationsguide](https://www.kimai.org/documentation/installation.html)
  - [Kimai – Docker-avbildningen](https://www.kimai.org/documentation/docker.html)
  - [Kimai – API-dokumentation](https://www.kimai.org/documentation/api/)
  - [Docker Hub – kimai/kimai2](https://hub.docker.com/r/kimai/kimai2)
  - [Kimai – svenska språkfilen](https://raw.githubusercontent.com/kimai/kimai/main/translations/messages.sv.xlf)
  - [GitHub – glazperle/kimai_mcp](https://github.com/glazperle/kimai_mcp)

---

Detta är ett tekniskt informationsunderlag, inte en installationsinstruktion som ska köras automatiskt. Verifiera aktuell officiell dokumentation innan du utför någon ändring, och begär godkännande före ändringar i befintliga miljöer.