Recruitee MCP server

Connect Recruitee 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.

Deploy RecruiteeBook a demo

What you can do with the Recruitee MCP server

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

  • Use the list departments & locations tool in Recruitee
  • Use the get candidate tool in Recruitee
  • Use the manage pipeline tool in Recruitee
  • Use the delete candidate tool in Recruitee
  • Use the search candidates tool in Recruitee
  • Use the update candidate tool in Recruitee

Supported Tools

list_departments_locations

List Departments & Locations

Retrieve all departments and office locations configured in the Recruitee account. Useful for finding department and location IDs when creating or updating job offers.

get_candidate

Get Candidate

Retrieve full details of a single candidate by ID, including their profile, placements (job assignments and pipeline stages), tags, sources, and custom fields.

manage_pipeline

Manage Pipeline

Assign a candidate to an offer or talent pool, change an existing placement stage, disqualify or requalify it, or remove the assignment. Removing a placement does not erase the candidate or its history.

delete_candidate

Delete Candidate

Delete a candidate and return its confirmed deletion timestamp. Deleted records may remain in provider history or be retrievable; this does not guarantee erasure of associated data.

search_candidates

Search Candidates

Search one page of candidates. Basic query searches names and offer titles; filters selects the documented advanced search with JSON filter objects.

update_candidate

Update Candidate

Update an existing candidate's profile information. Supports updating name, emails, phones, social links, cover letter, and CV. You can also update the CV separately via a remote URL.

create_candidate

Create Candidate

Create a new candidate in Recruitee. Optionally assign the candidate to job offers during creation. Use Manage Pipeline for an explicit talent-pool assignment. Manual candidate creation does not send an application confirmation email. Supports setting contact details, social links, cover letter, and a remote CV URL.

set_candidate_custom_fields

Set Candidate Custom Fields

Create profile fields on a candidate profile. This endpoint creates one field per request; it does not find and overwrite an existing field. Supports various field types including text, boolean, date, skills, salary, experience, education, and more. Supported **kind** values and their **values** format: - `single_line` / `multi_line`: `[{"text": "value"}]` - `boolean`: `[{"flag": true}]` - `skills`: `[{"text": "SQL"}, {"text": "Python"}]` - `salary`: `[{"amount": "5000", "currency": "EUR"}]` - `date` / `date_of_birth`: `[{"date": "2024-01-15"}]` - `gender`: `[{"value": "female"}]` - `nationality`: `[{"country_code": "NL"}]` - `language_skill`: `[{"language_code": "en", "level": "advanced"}]` - `experience`: `[{"title": "...", "company": "...", "startDate": "...", "endDate": "..."}]` - `education`: `[{"school": "...", "degree": "..."}]`

list_disqualify_reasons

List Disqualify Reasons

Retrieve all configured disqualification reasons. Use these reason IDs when disqualifying candidates through the Manage Pipeline tool.

create_offer

Create Job Offer

Create a new job offer or talent pool in Recruitee. Set the **kind** to "talent_pool" to create a talent pool instead of a job. New offers default to draft. A requested status uses a separate transition followed by a readback; a failed transition can leave the created offer in its actual earlier status. Publishing exposes it on the careers site.

manage_candidate_notes

Manage Candidate Notes

List, create a team-visible note, or delete an exact note from a candidate. Deletion verifies the note belongs to that candidate and is absent from the subsequent list.

get_offer

Get Job Offer

Retrieve full details of a job offer or talent pool by ID, including description, requirements, locations, department, tags, status, and pipeline stages.

manage_candidate_tags

Manage Candidate Tags

List company tags, add named tags to a candidate, or remove explicit tag names. Candidate changes are checked by reading the current profile.

update_offer

Update Job Offer

Update an existing job offer or talent pool. Change its title, description, requirements, locations, department, remote status, or publication status. Use the **status** field to publish, unpublish, close, or archive an offer.

list_offers

List Job Offers

List one page of job offers and talent pools, with current status and ID filters. Request subsequent pages to list the complete account.

download_candidate_file

Download Candidate File

Prepare the candidate’s current CV, uploaded cover letter, or an exact candidate file for download. Requires an existing file and permission to read that candidate. A cover-letter text field is not a downloadable file.

get_current_identity

Get Current Identity

Read the authenticated token owner and exact company binding from the company-scoped ATS API. Personal tokens inherit the creator’s company permissions.

delete_offer

Delete Job Offer

Delete an exact job offer or talent pool, then verify that its detail endpoint reports it absent. This does not guarantee erasure of candidate profiles, retained history, or audit records.

Connect Recruitee 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 Recruitee in Metorial. In your Metorial portal, enable the Recruitee 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 Recruitee tools.

Run Recruitee through the Metorial gateway

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

  • Give Recruitee and every other app to your whole team through one MCP gateway, behind your SSO.
  • Scope which teams and agents can use Recruitee 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 Recruitee

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 Recruitee

Manage candidates, job offers, talent pools, and candidate placements in the company-scoped ATS API. Search and update profiles, create profile fields and notes, add or remove candidate tags, transition offer and pipeline status, and prepare existing candidate files for download. Discover the authenticated identity, departments, locations, and disqualification reasons.

Frequently asked questions

Common questions about connecting Recruitee to AI agents with Metorial.

  1. How many tools does the Recruitee MCP server have?
    The Recruitee MCP server exposes 18 tools, including List Departments & Locations, Get Candidate, Manage Pipeline. Each one is governed and traced through Metorial.
  2. Recruitee 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 Recruitee MCP server through the same Metorial URL.
  4. Use role-based access control to decide which teams, users, and agents can use Recruitee and which of its tools they can call.
  5. Yes. Metorial is open source, so you can run the Recruitee MCP server yourself or use the hosted gateway.

Connect Recruitee to production AI agents

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

Book a demoDeploy Recruitee