Skip to content
MCP server

intelliHR MCP by usefulapi

Read intelliHR people, jobs, leave, skills and training; create and update people records.

Install
Runs
Remotely
Version
1.20.0
Listing updated
4 days ago

About intelliHR MCP by usefulapi

intelliHR 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 intellihr https://intellihr.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

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

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "intellihr": {
      "url": "https://intellihr.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": {
    "intellihr": {
      "type": "http",
      "url": "https://intellihr.usefulapi.io/mcp"
    }
  }
}

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

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

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

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

Tools this server provides (22)

Read directly from the server.

intellihr_list_people
List the people (employees) in intelliHR as at today: name, employee number, email, phone, addresses, emergency contact, employment status, their jobs (summary) and custom fields. Filter by name (matches any part of the name), email, employee number, job id, recently updated, or who is on extended leave. Health information is never returned. GET /people.
intellihr_get_person
One person's full record by id: names, date of birth, gender, employee number, contact details, addresses, emergency contact, employment status, jobs, work rights, user account and custom fields. Health information is never returned. GET /people/{id}.
intellihr_list_person_documents
The documents stored on a person's record (file name, type, size, upload status and a download link). Contents are not read. GET /people/{personId}/documents.
intellihr_list_person_skills
The skills assigned to a person (with their level and review details as intelliHR returns them). The whole list comes back at once. GET /people/{personId}/skills.
intellihr_list_person_tasks
Tasks (forms, reviews, check-ins, onboarding steps) for a person, by tab: DUE (default), ABOUT_ME, ABOUT_OTHERS, DONE or IGNORED. GET /people/{personId}/tasks.
intellihr_list_jobs
List jobs (roles people hold, past, current and future) as at today: person, position title, location, business unit and entity, supervisor, work type, FTE, remuneration schedule, start/end dates and status. Filter by person, job title, status (Current Job, Future Job, Ending Job, Past Job), work type, primary job, or upcoming/recent end dates. GET /jobs.
intellihr_get_job
One job by id with its person, position title, location, business unit, supervisor, pay grade, remuneration and dates. GET /jobs/{id}.
intellihr_get_job_timeline
The upcoming changes and current information about a job (scheduled changes, end date). GET /jobs/{jobId}/timeline.
intellihr_list_locations
The organisation's locations (sites) with parent location, code, address, enabled flag and representatives. GET /locations.
intellihr_list_business_units
The organisation's business units (departments, teams). Filter by name or identifier. GET /business-units.
intellihr_list_business_entities
The organisation's business entities (legal employers). GET /business-entities.
intellihr_list_position_titles
The position titles (job names) defined in intelliHR. Filter by name. GET /position-titles.
intellihr_list_pay_grades
The pay grades and their rates, optionally as at a date. GET /pay-grades.
intellihr_list_users
The user accounts that can sign in to intelliHR: username, enabled flag, permission groups and the linked person. GET /users.
intellihr_list_custom_field_definitions
The custom fields defined in intelliHR (what each field on a person, job or location means and its type). GET /custom-field-definitions.
intellihr_list_reference_data
Look up one of intelliHR's reference lists: employment_conditions, work_classes, work_types, work_rights, recruitment_sources, extended_leave_types, job_change_reasons, skill_disciplines, training_types, training_providers, qualification_types, qualification_library_items, onboarding_templates, permission_groups or representative_types. Use it to find the ids and names other tools need.
intellihr_list_skills
The skills catalogue, optionally only business-critical skills or one discipline. GET /skills.
intellihr_list_qualifications
Qualification records held by people (licences, certificates) with status and dates. Filter by person, employee number or library item. GET /qualifications.
intellihr_list_trainings
Training records completed or booked by people, with provider, type and dates. Filter by training name, provider, type, employee number or email. GET /trainings.
intellihr_create_person
WRITE: create a new person record in intelliHR (last name required). It creates the person only: no job, no user account and no welcome email is sent. A job is added separately in intelliHR. Check with list_people first to avoid duplicates. POST /people.
intellihr_update_person
WRITE: change fields on an existing person (only the fields you pass change): names, date of birth, gender, employee number, title and emergency contact. Contact details, addresses and jobs are not changed by this tool. PATCH /people/{id}.
intellihr_create_extended_leave
WRITE: record extended leave (parental, long service, unpaid, etc.) on an existing job. It changes the person's employment record and can trigger intelliHR workflows. The leave is created with the end date you give as expected; finalise it in intelliHR when the person returns. Find leave types with list_reference_data kind extended_leave_types. POST /extended-leave.

intelliHR MCP by usefulapi FAQ

How do I add intelliHR MCP by usefulapi to Claude Code?

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