Skip to content
MCP server

HR WORKS MCP by usefulapi

Read persons, organization units, absences, job postings and applications in HR WORKS.

Install
Runs
Remotely
Version
1.4.0
Listing updated
4 days ago

About HR WORKS MCP by usefulapi

HR WORKS MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Install

Run in a terminal

claude mcp add --transport http hrworks https://hrworks.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://hrworks.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "hrworks": {
      "url": "https://hrworks.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "hrworks": {
      "type": "http",
      "url": "https://hrworks.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "hrworks": {
      "serverUrl": "https://hrworks.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "hrworks": {
      "type": "http",
      "url": "https://hrworks.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (6)

Read directly from the server.

hrworks_list_persons
List the persons in the company, or in the given organization units, grouped by organization unit. Use it to find a person identifier. HR WORKS API: GET /v2/persons.
hrworks_get_person
Get the base data of one person (names, personnel number, uuid, external ids). HR WORKS API: GET /v2/persons/{personIdentifier}.
hrworks_list_organization_units
List the active organization units (departments, locations) with their number, uuid and name. HR WORKS API: GET /v2/organization-units.
hrworks_list_absences
List the absences (vacation, sickness and other absence types) of persons in a date interval. The interval may be one year at most. Paged: use nextPage. HR WORKS API: GET /v2/absences.
hrworks_list_posts
List the job postings (posts) of the company. Active posts are the open job postings; each post lists its offers with publicationDate and validUntilDate. Paged: use nextPage. HR WORKS API: GET /v3/applicant-management/posts.
hrworks_list_job_applications
List the job applications, optionally for given posts and status values. Each page holds 50 applications. Paged: use nextPage. HR WORKS API: GET /v2/applicant-management/job-applications.

HR WORKS MCP by usefulapi FAQ

How do I add HR WORKS MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http hrworks https://hrworks.usefulapi.io/mcp