AnythingMCP
Back to Guides

Personio MCP Server — DACH HR für KI-Agenten

Personio Mitarbeiter, Anwesenheiten und Abwesenheiten aus jedem KI-Agenten via MCP abfragen. Vorgefertigter Personio-Adapter in AnythingMCP für die führende DACH-HR-Plattform.

Pre-built adapter available on AnythingMCP Cloud

Skip the self-hosted setup — install this adapter in one click with a free trial. No credit card required.

Install on Cloud — Free Trial

Personio HR an KI-Agenten anbinden

Personio ist die dominierende HR-Plattform für KMU in DACH (Deutschland, Österreich, Schweiz). Mit Personio an MCP angebunden hat Ihr KI-Agent direkten Zugang zu Mitarbeiterdatensätzen, Arbeitszeitdaten, Abwesenheitsplänen und Time-off-Typen — ideal für HR-Self-Service-Bots, Manager-Dashboards und Schicht-/Personalplanungs-Assistenten.

Schnelleinrichtung mit integriertem Adapter

AnythingMCP enthält einen vorkonfigurierten Personio-Adapter. Sie hinterlegen einen einzelnen Bearer-Token.

Schritt 1: AnythingMCP bereitstellen

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d

Schritt 2: API-Zugangsdaten in Personio generieren

Im Personio-Admin: Einstellungen → Integrationen → API-Zugangsdaten → ein neues Paar mit den benötigten Scopes anlegen (Mitarbeiter, Anwesenheiten, Abwesenheiten, Time Offs).

Dann gegen einen Token tauschen via:

curl -X POST https://api.personio.de/v1/auth \
  -d 'client_id=IHR_CLIENT_ID&client_secret=IHR_CLIENT_SECRET'

Schritt 3: Adapter importieren

http://localhost:3000/connectors/store öffnen, Import beim Personio-Adapter klicken und den zurückgegebenen Token in das Feld PERSONIO_TOKEN einfügen.

Schritt 4: Mit KI-Agent verbinden

{
  "mcpServers": {
    "personio": {
      "url": "http://localhost:4000/mcp"
    }
  }
}

Verfügbare Tools

| Tool | Beschreibung | |------|-------------| | personio_list_employees | Liste mit Filter (E-Mail), Pagination | | personio_get_employee | Vollständiger Mitarbeiter inkl. Custom-Attribute | | personio_list_absences | Urlaub, Krankheit, Elternzeit mit Datumsbereich | | personio_list_attendances | Arbeitszeiten pro Mitarbeiter pro Datumsbereich | | personio_list_absence_types | Konfigurierte Typen mit ID, Name, Kategorie, Einheit |

KI-Anwendungsfälle

  • "Wer ist nächste Woche im Vertriebsteam im Urlaub?"
  • "Zeig mir die Anwesenheitsstunden für Jane Doe im März 2026"
  • "Liste alle Mitarbeiter im Büro Freiburg, die nach 2024 eingestellt wurden"
  • "Wie viele Krankheitstage hatte das Lager-Team in Q1?"

Token-Rotation Caveat

Personios /auth-Endpoint ist kein Standard-OAuth2 — jeder erfolgreiche API-Call gibt im Response-Header einen neuen Token zurück, der für den nächsten Call verwendet werden sollte. Dieser Adapter sendet bei jedem Request denselben Token. In der Praxis toleriert Personio Token-Wiederverwendung für mehrere Minuten, was für ad-hoc KI-Workflows ausreicht. Für Hochvolumen-Integrationen ist ggf. ein Custom-Proxy nötig, der pro Response Tokens rotiert.

Nächste Schritte