TalentHR MCP server

Read employees, leave, recruiting and reports; book or decide leave and add applicant notes. Hosted by usefulapi: connect it to Claude, ChatGPT, Cursor or any MCP client.

Connect TalentHRFree 50 tool calls / monthPro $9/mo · $90/yr · pricing33 tools

What can I ask?

Turn on the TalentHR connector, then ask in plain words. The AI picks the tools.

Who is on vacation next week, and who has a request still waiting for approval?
How many vacation days does Maria Ionescu have left this year?
Show our headcount by department and the hires and leavers of the last 12 months.
List the applicants for the open Sales Manager position and add a note to the latest one.

What you can do with TalentHR in Claude and ChatGPT

For HR teams with authorized TalentHR API access.

Review team availability

Read the team calendar and an employee’s pending or approved leave requests.

Check leave balances

Read an employee’s budget and usage for the current or a selected time-off cycle.

Review headcount trends

Compare company headcount, hires and leavers for a selected reporting period.

Book agreed time off

Create an employee’s time-off request. The manager is emailed for a decision unless preapproval is explicitly chosen and permitted.

Changes data

Respond to pending leave

Approve or reject a selected pending request when authorized. TalentHR emails the employee the decision.

Changes data

Record a recruiting note

Add an internal note to a selected job application for the hiring team.

Changes data

How do I connect TalentHR?

Before you connect

The login page asks for your TalentHR API key.

Create a key in TalentHR → Settings → Domain settings → API. Choose a read-only key if you only want to look things up: the three write tools then answer with a permission error. HR data is personal data, so give the key to this connection only if you are allowed to. Only connect HR data you are authorized to process with your chosen AI client and its LLM provider: requested employee, candidate, compensation, asset and time-off records reach those services; API keys do not. A customer API-enabled plan is required, and vendor charges are separate. Time-off booking emails the manager (or the employee if the manager is unavailable); approving/rejecting emails the employee. Preapproved requests bypass manager approval when permitted. Recruiting notes are internal. No request is automatically retried; check TalentHR after an uncertain write. Revoke the dedicated API key in TalentHR to stop access. Usage/billing follows the tenant domain when readable, otherwise the key; rotating a key without domain-settings access can change that identity.

Claude claude.ai · Desktop

Open Customize → Connectors, then click + Add → Add custom connector.
Enter the name TalentHR and this URL, then click Add:
https://talenthr.usefulapi.io/mcp
Claude opens the login page: enter your TalentHR API key.
In a chat, click + → Connectors and turn on TalentHR.

Team and Enterprise: an Owner adds the connector for the organization first.

ChatGPT chatgpt.com

Open Plugins, click +, then Add custom MCP server.
Enter the name TalentHR and this URL, choose OAuth as the authentication, confirm the warning and create it:
https://talenthr.usefulapi.io/mcp
ChatGPT opens the login page: enter your TalentHR API key.
In Plugins, install TalentHR, then choose it in a chat.

No Add custom MCP server option? It depends on your account or workspace settings: see OpenAI's guide.

Claude Code

Run this command, then run /mcp in Claude Code to log in:

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

Cursor

Add to Cursor or add this to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "talenthr": {
      "url": "https://talenthr.usefulapi.io/mcp"
    }
  }
}

VS Code

Add to VS Code or add this to .vscode/mcp.json:

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

Codex

Run these commands. The second one opens the login page:

codex mcp add talenthr --url https://talenthr.usefulapi.io/mcp

codex mcp login talenthr

Other clients

Windsurf, Cline, Zed and other MCP clients: add this URL as a remote MCP server (Streamable HTTP). The client then opens the login page in your browser.

https://talenthr.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: the login page asks for your TalentHR API key. If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.

Pricing

Plan	Price	Limit
Freeper TalentHR tenant/key	$0	50 tool calls / month
Proper TalentHR tenant/key	$9/mo · $90/yr	10,000 tool calls / month
Pro+per TalentHR tenant/key	$39/mo · $390/yr	100,000 tool calls / month

Each paid plan covers this TalentHR server only. Ask your AI to run talenthr_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with talenthr_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with talenthr_upgrade before then undoes the cancel. Or write to [email protected].

Tools 33

Show all 33 tools (the AI picks them for you)

Read only · 26

List employees (directory)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 slugs (from the company's custom fields). Returns personal data; summarize only what the user asked for.
Get directory filterstalenthr_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.
Get an employeetalenthr_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.
Get an employee's job historytalenthr_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.
Get the organization charttalenthr_get_organization_chart
List all current employees with their manager (reports_to_employee_id), job title and role, to answer who reports to whom.
List departmentstalenthr_list_departments
List all departments of the company with their ids (the ids are what talenthr_list_employees filters and employee records refer to).
List divisionstalenthr_list_divisions
List all divisions of the company with their ids (the ids are what talenthr_list_employees filters and employee records refer to).
List locationstalenthr_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).
List job titlestalenthr_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).
List time off typestalenthr_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.
List an employee's time off requeststalenthr_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.
Get an employee's time off balancestalenthr_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.
Get the time off calendartalenthr_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 with employee_id.
List holidaystalenthr_list_holidays
List the company holidays of a year (current year by default) with date and who they apply to.
List benefitstalenthr_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).
Get an employee's benefitstalenthr_get_employee_benefits
List the benefits one employee has (category, cost, start and end date).
List company assetstalenthr_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).
Get an employee's assetstalenthr_get_employee_assets
List the assets (inventory and memberships) assigned to one employee. Paged: use next_offset to continue.
List job positionstalenthr_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.
List applicants of a job positiontalenthr_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.
List all applicantstalenthr_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).
Get an applicanttalenthr_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.
Get the headcount reporttalenthr_get_headcount_report
Headcount per month over a period (total and optionally grouped by gender, location, department, division, ...), plus the current headcount.
Get the hires and leaves reporttalenthr_get_hires_leaves_report
Hires, terminations and attrition rate per month over a period.
Get the time off reporttalenthr_get_time_off_report
Approved, non-canceled time off summarized per month and per weekday, split by time off type, for a period.
List time tracking entriestalenthr_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.

Changes data · 3

Book a time off requesttalenthr_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 from today and inside a time off cycle. Optionally give amount_options (days per date: 1, 0.5, 0 for non-working days; every date from start to end needs a value); when omitted TalentHR works it out. Cannot be undone through this server.
Approve or reject a time off requesttalenthr_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).
Add a note to a job applicationtalenthr_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.

Your usefulapi plan · 4

Usage status (free-tier meter)talenthr_usage_status
Report the caller's current usage: the plan, calls used this month, the limit of the plan (the free monthly cap or the Pro fair use limit), remaining, and whether the limit is reached. Read-only; does not count against the meter.
Request a missing featuretalenthr_request_feature
Tell usefulapi that the user needs something the TalentHR tools cannot do yet (a missing tool, field or filter). Call it only when the user asks for something none of the tools can do, and tell the user that you send the request. Do not call it for errors or for normal requests. Do not include personal data, credentials or customer records. Stored with the product name and the client type (for example Claude or Cursor), without the user's account. At most 5 requests per day. Does not count against the meter.
Upgrade to Pro or Pro+talenthr_upgrade
Get a paid plan for TalentHR (the free tier caps monthly usage). Pro: 10,000 tool calls a month, for normal use — plan "monthly" ($9/month) or "yearly" ($90/year, 2 months free). Pro+: 100,000 tool calls a month, for automations and heavy use — plan "plus" ($39/month) or "plus_yearly" ($390/year). Without a plan it returns both Pro and Pro+, each with a payment link, for the user to choose; with a plan, one link. An existing Pro subscription changes to Pro+ in place (needs confirm: true; the price difference for the rest of the period is charged at once). Cancel any time: the plan then runs to the end of the paid period, so it also suits a one-time job. A link opens Stripe Checkout in the browser; after payment the account upgrades automatically. Does not count against the meter.
Cancel the Pro subscriptiontalenthr_cancel_subscription
Cancel the caller's TalentHR Pro subscription at the end of the paid period (no refund for the current period; Pro continues until then, then the free tier applies). Requires confirm: true. Run talenthr_upgrade later to undo the cancel before the period ends. Does not count against the meter.

FAQ

What can I do with TalentHR in Claude or ChatGPT?

Review team availability. Check leave balances. Review headcount trends. Book agreed time off. Respond to pending leave. Record a recruiting note. See what you can do for the details.

Is this an official TalentHR product?

No. usefulapi is an independent service. It is not affiliated with or endorsed by TalentHR. The server calls the TalentHR API with your own TalentHR access, so it sees only the data that your account can see.

Can I connect TalentHR to Claude or ChatGPT?

Yes. In Claude, add this server's URL as a custom connector. In ChatGPT, add it as a custom MCP server in Plugins. Then log in once. Cursor, VS Code, Claude Code and Codex work too. See the setup steps.

What do I need to connect?

The login page asks for your TalentHR API key. See Before you connect for where to find it.

Do I put my TalentHR key or an Authorization header in the client config?

No. 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: the login page asks for your TalentHR API key. If the config has such a header, remove it: some clients then send that header instead of the login token, and every call fails with 401.

How do you keep my TalentHR credentials?

The login stores them encrypted in the authorization grant of your connection. The server uses them to call the TalentHR API for you and to derive a private account id for usage metering. usefulapi does not show them on any page or in any reply. To stop all access, remove the connector and change or delete these credentials in TalentHR.

Can the AI change my TalentHR data?

Yes, if you approve it. 3 of the 29 TalentHR tools can create or change data. The other 26 are marked read-only. Most MCP clients ask you to approve a tool call before it runs.

What does it cost?

The Free plan gives 50 tool calls / month. Pro costs $9/mo or $90/yr, with 10,000 tool calls / month. Pro+ costs $39/mo or $390/yr, with 100,000 tool calls / month. Each subscription covers this TalentHR server only. Cancel any time: your paid plan then runs to the end of the paid period. Run talenthr_usage_status to see how many calls you used.

How do I subscribe or cancel?

Ask the AI to run talenthr_upgrade and choose Pro or Pro+, billed monthly or yearly: it returns a Stripe Checkout link. If you already have Pro, ask to change it to Pro+. After you confirm, your existing subscription changes in place, keeps its billing interval and charges the price difference for the rest of the period immediately. To cancel, run talenthr_cancel_subscription. Your paid plan continues to the end of the paid period.

What if a TalentHR tool that I need is missing?

Tell the AI what you wanted to do. It can send the request with talenthr_request_feature. We store the text with the server name, the type of AI client and the tool you tried, not with your account, and read every request when we plan new tools. You can send up to 5 requests per day.

Which AI clients can I use?

Any client that supports remote MCP servers (Streamable HTTP) with OAuth login: Claude (web and desktop), Claude Code, ChatGPT, Codex, Cursor, VS Code, Windsurf and others.

This is a Model Context Protocol endpoint — meant to be connected from an AI client, not opened in a browser. An invalid_token response at the URL is the auth gate working as designed; clients authenticate automatically.

Need a tool this server does not have, or a connection to another system? We build custom integrations and MCP servers.

More HR & Workforce MCP servers

All HR & Workforce servers →