AnythingMCP
Back to Guides

Personio MCP Server — DACH HR for AI Agents

Query Personio employees, attendances, and absences from any AI agent via MCP. Pre-built Personio adapter in AnythingMCP for the leading DACH HR platform.

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

Connect Personio HR to AI Agents

Personio is the dominant HR platform for SMBs across DACH (Germany, Austria, Switzerland). Connecting Personio to MCP gives your AI agent direct access to employee records, working-time data, absence schedules, and time-off types — perfect for HR self-service bots, manager dashboards, and shift/staffing assistants.

Quick Setup with Built-in Adapter

AnythingMCP ships with a pre-configured Personio adapter. You provide a single bearer token.

Step 1: Deploy AnythingMCP

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

Step 2: Generate API Credentials in Personio

In Personio admin: Settings → Integrations → API credentials → create a new pair with the scopes you need (Employees, Attendances, Absences, Time Offs).

Then exchange them for a token via:

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

Step 3: Import the Adapter

Open http://localhost:3000/connectors/store, click Import on Personio, and paste the returned token into the PERSONIO_TOKEN field.

Step 4: Connect to Your AI Agent

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

Available Tools

| Tool | Description | |------|-------------| | personio_list_employees | List with filter (email), pagination | | personio_get_employee | Full employee record incl. custom attributes | | personio_list_absences | Vacation, sick leave, parental leave with date range | | personio_list_attendances | Working hours per employee per date range | | personio_list_absence_types | Configured types with id, name, category, unit |

AI Agent Use Cases

  • "Who is on vacation next week in the sales team?"
  • "Show me the attendance hours for Jane Doe in March 2026"
  • "List all employees in the Freiburg office hired after 2024"
  • "How many sick days did the warehouse team take in Q1?"

Token Rotation Caveat

Personio's /auth endpoint is not standard OAuth2 — each successful API call returns a new token in the response header that should be used for the next call. This adapter sends the same token on every request. In practice Personio tolerates token reuse for several minutes, which is fine for ad-hoc AI workflows. For high-volume integrations you may need a custom proxy that rotates tokens per response.

Next Steps