AnythingMCP
Back to Guides

Personio MCP Server — HR DACH per agenti AI

Interroga dipendenti, presenze e assenze Personio da qualsiasi agente AI via MCP. Adapter Personio integrato in AnythingMCP per la principale piattaforma HR DACH.

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

Collegare Personio HR a agenti AI

Personio è la piattaforma HR dominante per le PMI in DACH (Germania, Austria, Svizzera). Collegando Personio a MCP dai al tuo agente AI accesso diretto a record dipendenti, dati di working time, programmi assenze e tipologie di time-off — perfetto per bot di self-service HR, dashboard manager e assistenti shift/staffing.

Setup rapido con adapter integrato

AnythingMCP include un adapter Personio preconfigurato. Fornisci un singolo bearer token.

Step 1: Deploy AnythingMCP

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

Step 2: Genera credenziali API in Personio

Nell'admin Personio: Settings → Integrations → API credentials → crea una nuova coppia con gli scope necessari (Employees, Attendances, Absences, Time Offs).

Poi scambiali per un token via:

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

Step 3: Importa l'adapter

Apri http://localhost:3000/connectors/store, clicca Import sull'adapter Personio e incolla il token restituito nel campo PERSONIO_TOKEN.

Step 4: Connetti al tuo agente AI

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

Tool disponibili

| Tool | Descrizione | |------|-------------| | personio_list_employees | Lista con filtro (email), pagination | | personio_get_employee | Record dipendente completo con custom attributes | | personio_list_absences | Ferie, malattia, congedo parentale con range di date | | personio_list_attendances | Ore lavorate per dipendente per range di date | | personio_list_absence_types | Tipologie configurate con id, nome, categoria, unità |

Casi d'uso AI

  • "Chi è in ferie la prossima settimana nel team vendite?"
  • "Mostrami le ore di presenza di Jane Doe a marzo 2026"
  • "Lista tutti i dipendenti dell'ufficio Friburgo assunti dopo il 2024"
  • "Quanti giorni di malattia ha avuto il team di magazzino in Q1?"

Token rotation caveat

L'endpoint /auth di Personio non è OAuth2 standard — ogni call API riuscita restituisce un token nuovo nell'header di risposta che dovrebbe essere usato per la chiamata successiva. Questo adapter invia lo stesso token a ogni richiesta. In pratica Personio tollera il riutilizzo del token per diversi minuti, sufficiente per workflow AI ad-hoc. Per integrazioni high-volume potrebbe servire un proxy custom che ruota i token per response.

Prossimi step