# HR WORKS MCP by usefulapi

> HR WORKS MCP by usefulapi is an MCP server. Read persons, organization units, absences, job postings and applications in HR WORKS. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Website:** https://usefulapi.io/hrworks/
- **Repository:** https://github.com/m190/usefulapi-mcp/tree/HEAD/servers/hrworks
- **MCP Registry name:** io.usefulapi/hrworks
- **Listing updated:** 2026-11-13

## About

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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://hrworks.usefulapi.io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "hrworks": {
      "url": "https://hrworks.usefulapi.io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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.

## 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

---
Source: https://ai-powered.com/mcp/hr-works-mcp-by-usefulapi
