Connector guide2-minute read5 MCP tools7 languages

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.

HCBy HelpCode teamUpdated 2 min read Open-source on GitHub

No credit card · 7-day trial · Self-host alternative available

Personio HR

Personio HR

Access employee records, attendances, absences, and time-offs via the Personio REST API. Personio is the dominant HR platform for DACH SMBs.

tools

5

Region

DE

Category

HR

Authentication

Bearer Token

Required env vars

PERSONIO_TOKEN
Install in one click on Cloud

7-day free trial · No credit card

  • 7-day free trial
    No credit card required
  • GDPR & SOC 2 ready
    EU data residency, audit logs
  • Open-source on GitHub
    Open source · AGPL-3.0
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

Skip the install. Get this working in under 2 minutes.

Start a free trial on cloud.anythingmcp.com, add the Personio HR in one click, then point your AI client (Claude, ChatGPT, Copilot or Cursor) at the generated MCP endpoint. No Docker, no git clone, zero engineering experience required.

Start free trial

Summary

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

Try asking

Example prompts for Personio HR

Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.

Personio HR · live via MCP
Share
Opus 4.7

Claude is AI and can make mistakes. Please double-check responses.

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

curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
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

ToolDescription
personio_list_employeesList with filter (email), pagination
personio_get_employeeFull employee record incl. custom attributes
personio_list_absencesVacation, sick leave, parental leave with date range
personio_list_attendancesWorking hours per employee per date range
personio_list_absence_typesConfigured 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

Was this guide helpful?

Your Personio HR agent is one click away.

Install the connector, paste the key, prompt your AI client. Free for 7 days, no credit card.

Related guides