Connect HR WORKS to ChatGPT — German HR via MCP

Connect HR WORKS to ChatGPT

HR WORKS is the Freiburg-based HR/payroll SaaS used by ~20,000 DACH SMBs. With AnythingMCP you expose HR WORKS to ChatGPT via MCP — your Custom GPT or MCP-native ChatGPT client can answer absence, working-time, and recruiting questions directly from the live HR data.

Quick Setup

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

1. In HR WORKS: Settings → API → Generate Access Key
2. Exchange for a JWT (15-min lifetime):

   curl -X POST https://api.hrworks.de/v2/authentication \
     -H 'Content-Type: application/json' \
     -d '{"accessKey":"...","secretAccessKey":"..."}'
   

3. Import HR WORKS in http://localhost:3000/connectors/store and paste the JWT into HRWORKS_TOKEN
4. (Optional) Sandbox: set HRWORKS_BASE_URL=https://api.demo-hrworks.de
5. Assign the connector to an MCP server

Connect to ChatGPT

{
  "mcpServers": {
    "hrworks": { "url": "https://your-anythingmcp-instance.com/mcp" }
  }
}

ChatGPT MCP support is rolling out via Custom GPT → Actions and the upcoming MCP-native client. The endpoint must be HTTPS for ChatGPT to reach it from the public internet.

Use Cases

• "Show next week's absences for the engineering org unit" — line-manager triage
• "Total sick days by department for Q1" — exec-dashboard answers
• "Working-time totals for personnel number 1042 in March" — payroll prep
• "List remote-work entries for Müller, Hans this month" — hybrid policy check
• "Pipeline for the Berlin Frontend job posting" — recruiter handoff

Pro Tips for ChatGPT

• Limit dates: HR WORKS caps beginDate/endDate at 1 year (31 days with interval=days) — phrase queries within those windows
• Identifiers: most person endpoints accept either personnel number or username — tell ChatGPT which one you'll use
• Token tokens: every tool call shows up in ChatGPT's billing — use hrworks_health_check for connectivity tests instead of expensive list calls
• Token lifetime: refresh HRWORKS_TOKEN via cron + AnythingMCP admin API for long-running custom GPTs

Related Guides

• HR WORKS MCP Server overview
• Connect HR WORKS to Claude
• Personio MCP Server — alternative DACH HR
• Kenjo HR MCP Server — alternative DACH HR