Connector guide2-minute read31 MCP toolsEnglish · Deutsch · Italiano

How to Connect Hrworks to Gemini — 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.

HCBy HelpCode teamUpdated 2 min read Open source on GitHub

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

HR WORKS

MCP connector

HR WORKS

Access HR WORKS, the German HR/payroll platform: employees, absences, sick leaves, remote work (home office), working times, projects, applicants, organization units, holidays and cost centers via the v2 REST API.

Tools

31

Region

DE

Category

HR

Authentication

Bearer Token

Required env vars

HRWORKS_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
    Source-available BSL-1.1
  • Works with ChatGPT, Claude, Gemini
    Any MCP-compatible client

No install? Use cloud.anythingmcp.com directly.

Sign in, install the HR WORKS in one click, paste the credentials, mint an MCP API key — done. No Docker, no git clone, no local server to run.

Open Cloud

TL;DR

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.

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

ToolWhen 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_leavesSick-leave analytics, trend questions
hrworks_list_working_timesOvertime calculation, payroll prep
hrworks_list_remote_workHybrid-policy compliance, office-day counts
hrworks_list_applicantsRecruiting pipeline overview
hrworks_get_leave_accountPer-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

Was this guide helpful?

Ready to ship

Your HR agent is one click away.

Install the connector, paste the key, prompt Gemini. Free for 7 days, no credit card.

Related guides