About HR WORKS MCP by usefulapi
HR WORKS MCP by usefulapi is a hosted, read-only MCP server for HR WORKS account holders using Claude, Cursor, or other MCP clients. It provides access to people, organizational units, absences, job postings, and applications without modifying HR data.
Key features
- 01List and retrieve people records
- 02List organizational units
- 03Read absence records
- 04List job postings and applications
Use cases
- 01Look up a person’s HR record
- 02Review organizational units and absences
- 03Check job postings and applications
MCP support
Exposes HR WORKS people, organizational unit, absence, job posting, and application records through read-only MCP tools. Clients connect to its hosted endpoint and authenticate with an HR WORKS API key pair.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://hrworks.usefulapi.io/mcpclaude mcp add --transport http io-usefulapi-hrworks https://hrworks.usefulapi.io/mcp{"mcpServers":{"io-usefulapi-hrworks":{"type":"http","url":"https://hrworks.usefulapi.io/mcp"}}}Open in Cursor{"servers":{"io-usefulapi-hrworks":{"type":"http","url":"https://hrworks.usefulapi.io/mcp"}}}Open in VS Code{"mcpServers":{"io-usefulapi-hrworks":{"type":"http","url":"https://hrworks.usefulapi.io/mcp"}}}{"mcpServers":{"io-usefulapi-hrworks":{"serverUrl":"https://hrworks.usefulapi.io/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
Tools
Details
From the project READMEHR WORKS MCP by usefulapi
Use your HR WORKS account from Claude, Cursor, or any MCP client. It reads persons, organization units, absences, job postings and applications, and it changes nothing. Hosted, no local install: connect with your own credentials.
Live endpoint: https://hrworks.usefulapi.io/mcp · Homepage: https://usefulapi.io
Connect
- Claude (claude.ai, Desktop): open Customize → Connectors, click + Add → Add custom connector, and paste
https://hrworks.usefulapi.io/mcp. - Claude Code:
claude mcp add --transport http hrworks https://hrworks.usefulapi.io/mcp, then run/mcpto log in. - VS Code: Add to VS Code.
- Cursor and other clients: add the URL as a remote MCP server:
{
"mcpServers": {
"hrworks": {
"url": "https://hrworks.usefulapi.io/mcp"
}
}
}
Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your HR WORKS credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/hrworks/
On first connect you provide the HR WORKS access key and secret access key of an API key pair. An HR WORKS API administrator creates the pair under Administrator → Basics → HRworks API, and the secret is shown only once. The server validates the pair and stores it per user. No keys go in config files.
Tools
| Tool | Type | What it does |
|---|---|---|
hrworks_list_persons | read | List persons |
hrworks_get_person | read | Get person |
hrworks_list_organization_units | read | List organization units |
hrworks_list_absences | read | List absences |
hrworks_list_posts | read | List job postings |
hrworks_list_job_applications | read | List job applications |
hrworks_usage_status | meta | Usage status (free-tier meter) |
hrworks_request_feature | meta | Request a missing feature |
hrworks_upgrade | meta | Upgrade to Pro or Pro+ |
hrworks_cancel_subscription | meta | Cancel the Pro subscription |
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Pricing
| Plan | Price | Limit |
|---|---|---|
| Free | $0 | 50 tool calls / month |
| Pro (per user) | $9/mo or $90/yr (2 months free) | Unlimited* |
*Pro has a fair use limit of 10,000 tool calls a month on this server. For more, write to [email protected].
Pro covers this server only. Subscribe with hrworks_upgrade (it returns a Stripe Checkout link). Cancel any time with hrworks_cancel_subscription: Pro continues to the end of the paid period, with no refund for the current period, and running hrworks_upgrade before then undoes the cancel. Or write to [email protected].
License
MIT — see LICENSE. Documentation only; the server is hosted.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.