Talenthr MCP server

Connect Talenthr to Claude, ChatGPT, Cursor, Claude Code, Codex, Gemini, GitHub Copilot and any other MCP client, for your whole team. Metorial adds security, governance, and tracing, and gives everyone one Magic MCP URL to connect.

What you can do with the Talenthr MCP server

Ask your agent in plain language. Each of these maps to a real tool on the server.

  • Use the list employees tool in Talenthr
  • Use the update employee tool in Talenthr
  • Use the list organizational structure tool in Talenthr
  • Use the create department tool in Talenthr
  • Use the create job title tool in Talenthr
  • Use the create location tool in Talenthr

Supported Tools

list_employees

List Employees

Retrieve the employee directory from TalentHR. Returns a paginated list of employees with their basic profile, job assignment, and organizational details. Use this to browse the workforce, find specific employees, or get an overview of the organization.

update_employee

Update Employee

Update an existing employee's profile data in TalentHR. Supports updating personal info, contact details, address, emergency contact, social media links, identification documents, and other profile fields. Only provide the fields you want to change. If firstName, lastName, or email is omitted, this tool first reads the employee profile and resubmits those existing required values. The update fails if that profile cannot supply them.

list_organizational_structure

List Organizational Structure

Retrieve organizational structure data from TalentHR including departments, divisions, job titles, locations, and employment statuses. Select which types to include in the response. Useful for discovering available IDs when creating or updating employees.

create_department

Create Department

Create a new department in TalentHR. Departments are organizational units used to group employees and structure the company hierarchy.

create_job_title

Create Job Title

Create a new job title in TalentHR. Job titles define the roles available in the organization and can be assigned to employees.

create_location

Create Location

Create a new work location in TalentHR. Provide name, address, and isRemote; TalentHR requires all three. Locations can be assigned to employees.

respond_time_off_request

Respond to Time Off Request

Approve or reject an employee's time off request in TalentHR. Requires the employee ID, the specific time off request ID, and whether to accept or reject it.

create_division

Create Division

Create a new division in TalentHR. Divisions represent major organizational segments such as regions or business units.

list_job_applications

List Job Applications

List job applications (ATS applicants) from TalentHR. Optionally filter by a specific job position. Use this to review incoming applications for open roles.

hire_employee

Hire Employee

Hire a new employee and register them in the TalentHR system. Creates the employee record with their personal details, job assignment, compensation, and optionally triggers the onboarding process. Use this to onboard new hires into the organization with their department, division, job title, location, and pay details.

list_time_off_requests

List Time Off Requests

List time off requests for a specific employee in TalentHR. Returns the requests with their type, dates, and current status. Use this to review pending requests before approving or rejecting them.

list_job_positions

List Job Positions

List TalentHR job positions, including position IDs and titles, published state, and application pipeline details returned by TalentHR. Use the IDs to filter list_job_applications.

get_time_off_budgets

Get Time Off Budgets

Get fixed and accrual time-off budgets for a TalentHR employee. Budget amounts remain provider decimal strings. Results may include historical cycles; optionally select the active cycle or a specific cycle.

get_employee

Get Employee

Get a detailed TalentHR employee profile by an employee ID from list_employees. Includes personal details, job relationships, custom fields, and contact information available to the API key.

get_calendar

Get Calendar

Get TalentHR employee absences and holidays for a date range. Results include pending and approved time off, and may include terminated employees. Use filter to narrow status or organizational groups. If endDate is omitted, TalentHR uses the end of the start month.

list_reference_data

List Reference Data

Discover TalentHR countries, nationalities, relationship types, languages, or time-off types for employee profiles and leave workflows. Numeric IDs and provider-specific fields remain available for subsequent calls.

Connect Talenthr to your AI client

Every client uses the same Magic MCP URL, and so does any other MCP client. Add it once and sign in with SSO.

  1. Enable Talenthr in Metorial. In your Metorial portal, enable the Talenthr MCP server and sign in with the account that owns the data. Access stays governed by your team policies.
  2. Add a custom connector. Open Customize, then Connectors. Select Add, then Custom, then Web.
  3. Paste your Metorial MCP URL. Name it Metorial, paste your Magic MCP URL (<your-magic-mcp-url>) and continue.
  4. Sign in. Select Add and sign in to load Talenthr tools.

Run Talenthr through the Metorial gateway

One governed layer for every app your agents reach, not a separate connector per tool.

  • Give Talenthr and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Talenthr tools with role-based access control, and trace every call.
  • Prefer to run it yourself? Metorial is open source and self-hostable.

More integrations teams use with Talenthr

Linkedin

Authenticate LinkedIn members with OpenID Connect, fetch the authenticated member profile, and create self-serve LinkedIn shares with text, article links, and uploaded images. Organization and Community Management workflows should move to a separate slate because LinkedIn restricts combining those products in one app.

Workable

Manage recruiting, hiring, and HR processes. Create and track job postings, manage candidates through hiring pipelines, and handle employee records. Create, move, disqualify, and comment on candidates. Manage requisitions with approval workflows. Retrieve offers and scheduled events like interviews. Create and manage departments. Handle employee data, documents, and time-off requests. Build custom careers pages with public job listing endpoints.

Ashby

Read and manage candidates, applications, jobs, offer forms and interview schedules. Discover required organization resources, inspect the connected API key and download provider files.

Async Interview

Review asynchronous interview campaigns and candidate submissions. List interview jobs, retrieve interview responses with candidate details and recording links, and filter responses by job.

Bamboohr

Read and update visible BambooHR employee records and tables, time off, timesheets, goals and training records. Discover employee IDs, current reports and active applicant statuses. Read company benefit summaries and employee dependents, retrieve applicant tracking data, generate reports and download employee or company files. Permissions and company configuration determine availability.

Breathe Hr

Read employee, absence, sickness, organization, compensation and training records. Create employee and sickness records, request or decide leave, cancel absences, and manage expenses and claims. Discover the connected account and available configuration records.

Technical notes for Talenthr

Manage TalentHR employee profiles, hiring, organizational structure, time-off requests, and applicant tracking. Discover employees and job positions, inspect calendar absences and leave budgets, and approve or reject leave requests.

Frequently asked questions

Common questions about connecting Talenthr to AI agents with Metorial.

  1. How many tools does the Talenthr MCP server have?
    The Talenthr MCP server exposes 16 tools, including List Employees, Update Employee, List Organizational Structure. Each one is governed and traced through Metorial.
  2. Talenthr exposes tools your agents call on demand; it does not publish event triggers yet. Everything still runs through one governed MCP URL.
  3. Any MCP client, including VS Code, Windsurf, Zed, OpenCode and Grok. Each one reaches the Talenthr MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Talenthr and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Talenthr MCP server yourself or use the hosted gateway.

Connect Talenthr to production AI agents

See how Metorial gives your team governed access to Talenthr, with tracing and security controls built in.