MCP server
TalentHR MCP by usefulapi
Read employees, leave, recruiting and reports; book or decide leave and add applicant…
- Runs
- Remotely
- Version
- 1.12.0
- Listing updated
- 5 days ago
About TalentHR MCP by usefulapi
TalentHR MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.
Read employees, leave, recruiting and reports; book or decide leave and add applicant notes.
Install
Run in a terminal
claude mcp add --transport http talenthr https://talenthr.usefulapi.io/mcpAdd to Settings → Connectors → Add custom connector
https://talenthr.usefulapi.io/mcpInstall in CursorOpens Cursor, which asks you to confirm. Or add it by hand:
Add to ~/.cursor/mcp.json
{
"mcpServers": {
"talenthr": {
"url": "https://talenthr.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": {
"talenthr": {
"type": "http",
"url": "https://talenthr.usefulapi.io/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"talenthr": {
"serverUrl": "https://talenthr.usefulapi.io/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"talenthr": {
"type": "http",
"url": "https://talenthr.usefulapi.io/mcp"
}
}
}Tools this server provides (29)
Read directly from the server.
- talenthr_list_employees
- List the company's employees from the TalentHR directory with name, e-mail, job title, department, division, location, employment status, manager id, hire date and phone. Paged (limit max 100): use next_offset to continue. Filter by location, department, division or employment status (emp_state) with `filter`; get the ids from talenthr_get_directory_filters. Use `custom_fields` to add extra field
- talenthr_get_directory_filters
- List the valid filter options (departments, divisions, locations, employment statuses) with their ids, to build the `filter` argument of talenthr_list_employees and talenthr_get_calendar.
- talenthr_get_employee
- Get one employee's profile: birth date, hire and termination date, personal e-mail, work phone, address, nationality, gender, job title, department, division, location, role, seniority and custom fields. Contains sensitive personal data (it can include the SSN); only fetch it when the user asked about that person.
- talenthr_get_employee_job
- Get one employee's job information: employment status history, manager records, job records (title, department, location over time), compensation records and benefits. Compensation is sensitive; only fetch it when the user asked.
- talenthr_get_organization_chart
- List all current employees with their manager (reports_to_employee_id), job title and role, to answer who reports to whom.
- talenthr_list_departments
- List all departments of the company with their ids (the ids are what talenthr_list_employees filters and employee records refer to).
- talenthr_list_divisions
- List all divisions of the company with their ids (the ids are what talenthr_list_employees filters and employee records refer to).
- talenthr_list_locations
- List all locations (with address and remote flag) of the company with their ids (the ids are what talenthr_list_employees filters and employee records refer to).
- talenthr_list_job_titles
- List all job titles of the company with their ids (the ids are what talenthr_list_employees filters and employee records refer to).
- talenthr_list_time_off_types
- List the time off types (vacation, sick leave, ...) with id, yearly budget, whether approval is needed and whether it is paid. The id is needed to book a request with talenthr_create_time_off_request.
- talenthr_list_employee_time_off_requests
- List one employee's time off requests (dates, type, days, approved or pending, canceled). Paged: use next_offset to continue. A request with approved=null is still pending.
- talenthr_get_employee_time_off_budgets
- Get one employee's time off budgets per type and cycle: budget, original budget, used days and accrual figures, i.e. how many days they have left. Optionally limit to the current cycle (active) or one cycle id.
- talenthr_get_calendar
- Who is off when: employees with their time off requests and the holidays for a date range. Without end_date the range runs to the end of the start month (max 2 years). Without a filter it includes every employee (also terminated). Filter with keys time_off (pending, approved), department, division, location, emp_state and time_off_type (e.g. time_off=pending,approved;department=6), or one employee
- talenthr_list_holidays
- List the company holidays of a year (current year by default) with date and who they apply to.
- talenthr_list_benefits
- List the company's benefits with category, cost, dates and who they are required for. Optional `filter` with keys location, department, division, job_title, emp_state and employee (e.g. location=36;emp_state=1,2).
- talenthr_get_employee_benefits
- List the benefits one employee has (category, cost, start and end date).
- talenthr_list_assets
- List the company's assets (laptops, phones, subscriptions, memberships) with status, category, serial number, cost, purchase and warranty dates. Paged: use next_offset to continue. `search` matches name, description or category; `filter` takes status and category ids (e.g. status=1,2;category=19).
- talenthr_get_employee_assets
- List the assets (inventory and memberships) assigned to one employee. Paged: use next_offset to continue.
- talenthr_list_job_positions
- List the company's job positions (open and closed) with title, status, location, department, publish date and the hiring steps. The id is used to list a position's applicants.
- talenthr_list_job_position_applicants
- List the applicants of one job position with contact data, current hiring step and whether they are disqualified. Paged: use next_offset to continue. `search` matches first name, last name and e-mail.
- talenthr_list_applicants
- List every candidate across all job positions with contact data and the number of applications. Paged: use next_offset to continue. `search` matches first name, last name and e-mail; `starred_only` returns only the starred candidates (the talent pool).
- talenthr_get_applicant
- Get one candidate with contact data, description, CV info and all applications with the hiring step each one is in. The application ids are used by talenthr_create_applicant_note.
- talenthr_get_headcount_report
- Headcount per month over a period (total and optionally grouped by gender, location, department, division, ...), plus the current headcount.
- talenthr_get_hires_leaves_report
- Hires, terminations and attrition rate per month over a period.
- talenthr_get_time_off_report
- Approved, non-canceled time off summarized per month and per weekday, split by time off type, for a period.
- talenthr_list_time_tracking_entries
- List time tracking entries across all employees (start, end, duration, tags) for a period or date range. Paged: use next_offset to continue. working_now=true lists only running timers. Needs a key whose user may see everyone's time tracking.
- talenthr_create_time_off_request
- WRITE: book a time off request for an employee (talenthr_list_time_off_types gives the type id). Unless preapproved=true, TalentHR automatically E-MAILS THE EMPLOYEE'S MANAGER to approve or reject it. preapproved=true auto-approves it when the key's user is allowed to (so no manager decides): only use it when the user explicitly said the time off is already approved. Dates must be within one year
- talenthr_reply_time_off_request
- WRITE: approve (accept=true) or reject (accept=false) a pending time off request. TalentHR automatically E-MAILS THE EMPLOYEE the decision. A request that was already answered or canceled cannot be answered again. Only do this when the user explicitly asked for that decision on that request (find ids with talenthr_list_employee_time_off_requests or talenthr_get_calendar).
- talenthr_create_applicant_note
- WRITE: add an internal note to a job application (visible to the hiring team in TalentHR; no one is e-mailed). Needs the job position id and the application id (talenthr_get_applicant lists an applicant's applications with their job_position_id). Notes cannot be edited or deleted through this server.
TalentHR MCP by usefulapi FAQ
How do I add TalentHR MCP by usefulapi to Claude Code?
Run this command in your terminal: claude mcp add --transport http talenthr https://talenthr.usefulapi.io/mcp