Back to Guides

Connect HR WORKS to Claude — German HR via MCP

Wire HR WORKS into Claude AI via MCP. Query employees, absences, sick leaves, working times, and applicants in natural language. Pre-built v2 adapter with 31 tools.

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 HR WORKS to Claude

HR WORKS is the Freiburg-based HR/payroll SaaS used by ~20,000 DACH SMBs. With AnythingMCP you connect HR WORKS to Claude AI via MCP and run people-ops workflows in natural language — absence approvals, working-time analytics, applicant triage — all from a chat surface.

What You Can Ask Claude

  • "Who is on vacation next week in the engineering team?"
  • "Show me the sick-leave totals for Q1 2026 across all org units"
  • "List the working-time entries for personnel number 1042 in March"
  • "Which applicants are in the pipeline for the Berlin Frontend role?"
  • "Get the leave-account balance for Jane Doe"

Setup

git clone https://github.com/HelpCode-ai/anythingmcp.git
cd anythingmcp && docker compose up -d
  1. In HR WORKS admin: Settings → API → Generate Access Key (accessKey + secretAccessKey)
  2. Exchange them for a JWT (~15 min lifetime):
    curl -X POST https://api.hrworks.de/v2/authentication \
      -H 'Content-Type: application/json' \
      -d '{"accessKey":"...","secretAccessKey":"..."}'
    
  3. Open http://localhost:3000/connectors/store, import HR WORKS, paste the JWT into HRWORKS_TOKEN
  4. (Optional) For sandbox: set HRWORKS_BASE_URL=https://api.demo-hrworks.de
  5. Assign the connector to an MCP server

Connect Claude

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

Tool Highlights for Claude

| Tool | When Claude reaches for it | |------|---------------------------| | hrworks_list_persons | "List employees", directory queries, headcount checks | | hrworks_list_absences | "Who is off?", absence approvals, planning | | hrworks_list_sick_leaves | Sick-leave analytics, trend questions | | hrworks_list_working_times | Overtime calculation, payroll prep | | hrworks_list_remote_work | Hybrid-policy compliance, office-day counts | | hrworks_list_applicants | Recruiting pipeline overview | | hrworks_get_leave_account | Per-person leave balance lookup |

Full list of all 31 tools is in the HR WORKS MCP Server overview.

Important: Token Lifetime

The JWT expires after ~15 minutes. For ad-hoc Claude conversations this is fine — you mint a token and chat. For Claude scheduled workflows or long-running agents, automate a token refresh and update HRWORKS_TOKEN via the AnythingMCP admin API.

Date Interval Cap

hrworks_list_absences, _sick_leaves, _remote_work, _working_times cap at 1 year per call (or 31 days if interval=days). For multi-year analyses, ask Claude to iterate year by year.

Related Guides