Connector guide5-minute read31 MCP tools7 languages

Connect HR WORKS to Meta Muse — German HR via MCP

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

HCBy HelpCode teamUpdated 5 min read Open-source on GitHub

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

HR WORKS

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

Sign-in token

Required env vars

HRWORKS_ACCESS_KEYHRWORKS_SECRET_ACCESS_KEY
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 HR WORKS 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

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

Try asking

Example prompts for HR WORKS

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

HR WORKS · live via MCP
Share
Opus 4.7

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

Connect HR WORKS to Muse

HR WORKS is the Freiburg-based HR/payroll SaaS used by ~20,000 DACH SMBs. With AnythingMCP you connect HR WORKS to Muse 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 Muse

  • "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

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
  1. In HR WORKS: Administration → API, create an API key pair (accessKey + secretAccessKey)
  2. Open http://localhost:3000/connectors/store, import HR WORKS and paste the pair into HRWORKS_ACCESS_KEY and HRWORKS_SECRET_ACCESS_KEY. The connector exchanges it for a short-lived token and renews the token on its own.
  3. (Optional) For the sandbox at https://api.demo-hrworks.de, change the connector's base URL and the login URL in its auth settings to the demo host
  4. Assign the connector to an MCP server

Connect Muse

The quickstart above listens on localhost only. For Muse, install the connector on AnythingMCP Cloud instead, or on an instance with a public HTTPS address.

Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide shows YOUR_SERVER_ID.

Muse adds remote MCP servers as custom connectors and signs in to them with OAuth.

  1. In Muse, open Settings → Connectors and choose Add custom connector.
  2. Paste the MCP server URL https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID.
  3. Muse opens the AnythingMCP sign-in page: sign in and approve access.
  4. In a chat, ask Muse for something that needs the HR WORKS tools.

You can also set it up from a chat, on the web, in the iOS and Android apps or in WhatsApp. Send Muse this message:

Create a Custom Connector for a new remote MCP server, then connect to it:
Name: AnythingMCP
Transport: remote streamable HTTP
URL: https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID
Auth: OAuth

Self-hosting? Use your instance's public HTTPS address instead of https://cloud.anythingmcp.com. Muse connects from Meta's cloud, so localhost does not work.

Tool Highlights for Muse

ToolWhen Muse 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
hrworks_health_checkCheck whether the HR WORKS API is reachable
hrworks_list_organization_unitsList all active organization units (Organisationseinheiten) of the company with their uuid, number and name
hrworks_get_organization_unitReturn the data of a specific organization unit
hrworks_list_present_personsList all persons currently 'in the office' for a given organization unit
hrworks_list_permanent_establishmentsList all permanent establishments (Betriebsstätten) of the company with id and name
hrworks_list_holidaysList company holidays for a given year and (optionally) country
hrworks_get_personReturn the base data of a specific person (employee)
hrworks_list_persons_master_dataReturn the current master data (full personal data, contract details, addresses, bank info, etc.) for one or more persons
hrworks_get_persons_todayReturn day-related objects (working hours, attendance, absences) for the current day for one or more persons
hrworks_list_absence_typesList all absence types (vacation, parental leave, special leave, etc.) configured for the customer account, with their keys for use as…
hrworks_list_vacation_typesList vacation types defined for the customer account (subset of absence types focused on vacation/leave)
hrworks_list_sick_leave_typesList all sick leave types configured for the customer account with their keys (used as filter values for hrworks_list_sick_leaves)
hrworks_list_time_recording_regulationsList all time-recording regulations configured for the customer (defines which working time types are allowed per regulation)
hrworks_list_projectsList time-tracking projects of the company
hrworks_get_projectReturn the data of a specific time-tracking project by id
hrworks_list_project_customersList the customers used for project time tracking
hrworks_list_job_applicationsList job applications
hrworks_list_postsList all recruiting posts (job postings) of the company
hrworks_get_postReturn the data of a single recruiting post by uuid
hrworks_get_applicantReturn data of a specific applicant by uuid
hrworks_list_cost_centersList all cost centers (Kostenstellen) of the company with their number/id and name
hrworks_list_cost_objectivesList all cost objectives (Kostenträger) of the company
hrworks_list_wage_salary_typesList all wage/salary types defined for the customer account (used in payroll exports)

(showing 30 of 31 tools — install the connector to see them all)

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

Important: Token Lifetime

HR WORKS tokens expire after ~15 minutes. The connector logs in with your key pair, renews the token before it expires and logs in again after a 401, so long conversations, scheduled runs and agents keep working without you touching a token.

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 Muse to iterate year by year.

FAQ

Where is Muse available? Meta currently offers Muse in the US and Canada, on the web, in the iOS and Android apps and in WhatsApp.

Does Meta review this connector? No. Meta doesn't review custom connectors. Muse sees only the tools you switched on for this MCP server in AnythingMCP, and you can disconnect it anytime under Settings → Connectors.

Was this guide helpful?

Your HR WORKS agent is one click away.

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

Related guides