# Recruitee — MCP server on mcp.ai
> Connect your Recruitee account and use 23 tools for talent and recruitment straight from your AI agent. Connect with your own API key. Recruitee is a collaborative hiring software that streamlines recruitment processes, enabling teams to source, interview, and hire candidates efficiently.

By: mcp.ai · official
Page: https://mcp.ai/recruitee

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_recruitee?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/recruitee/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/recruitee/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/recruitee/skill.md
Postman collection (v2.1): https://mcp.ai/recruitee/postman.json

## Tools
- recruitee_create_candidate(name: string, tags?: string[], email?: string, phone?: string, photo?: string, offers?: integer[], resume?: string, source?: string, cover_letter?: string, social_links?: string[], custom_fields?: object) — Tool to create a new candidate profile. Use after gathering all candidate details. Example: "Create a new candidate named Jane Doe with email jane.doe@example.com."
- recruitee_create_note(note: object, candidate_id: string) — Creates a new note for a candidate in Recruitee. Notes can be used to record interview feedback, assessments, or any observations about the candidate. Use this when you need to add commentary or docum
- recruitee_create_offer(offer: object) — Creates a new job offer or talent pool in Recruitee. Required fields include title, location IDs, and description. Use Get Locations action to retrieve valid location IDs before creating an offer. The
- recruitee_delete_candidate(candidate_id: integer) — Tool to delete a candidate profile. Use when you need to permanently remove a candidate from your Recruitee account. Returns no content on success.
- recruitee_delete_tag(tag_id: integer) — Permanently deletes a tag from Recruitee by its ID. This action requires appropriate API permissions to delete tags. Use this when you need to remove unused or obsolete tags. Note: Deleting a tag remo
- recruitee_get_candidate(company_id?: integer|string, candidate_id: integer) — Tool to retrieve detailed information about a specific candidate. Use when you need the candidate's full profile before proceeding.
- recruitee_get_candidates(ids?: integer[], sort?: string, limit?: integer, query?: string, offset?: integer, deleted?: boolean, offerId?: integer, qualified?: boolean, company_id?: integer|string, createdAfter?: string, disqualified?: boolean) — Tool to retrieve a list of all candidates in the company. Use when you need to fetch or filter candidates before proceeding.
- recruitee_get_company_id() — Tool to retrieve the company ID of the authenticated account. Use when you need to confirm your company identity before other operations.
- recruitee_get_company_offer_public(identifier: string) — Tool to retrieve a specific published job offer by ID or slug from the public Careers Site API. Use after you have the offer identifier.
- recruitee_get_departments() — Tool to retrieve a list of company departments. Use when you need to reference or assign offers or candidates to departments.
- recruitee_get_locations() — Tool to retrieve a list of company locations. Use when you need to see all location options before assigning them to offers.
- recruitee_get_notes(limit?: integer, offset?: integer, candidate_id: integer) — Tool to retrieve a list of notes for a specific candidate. Use after confirming the candidate exists when you need to review their notes.
- recruitee_get_offers(limit?: integer, query?: string, offset?: integer, company_id?: integer|string) — Tool to retrieve a list of all job offers. Use after authentication to browse or paginate your company's complete set of offers.
- recruitee_get_pipeline_stages(offer_id: integer) — Tool to retrieve pipeline stages of a job offer. Use when you have the offer ID and need its stages to track candidate progression. Example: "Get pipeline stages for offer ID 456."
- recruitee_get_tags(page?: integer, query?: string, sort_by?: string, per_page?: integer, sort_order?: string) — Retrieve all tags with optional filtering and pagination. Search by name, sort by name or usage count, and paginate through results.
- recruitee_list_eeo_job_categories() — Tool to retrieve available EEO (Equal Employment Opportunity) job categories. Use when you need to see standard EEO job classification options.
- recruitee_list_invoices(company_id?: integer|string) — Tool to list invoices for a company. Use to retrieve billing invoice records.
- recruitee_list_localization_settings() — Tool to retrieve localization settings including proposed time format and start day of the week. Use when you need to check regional or time display preferences.
- recruitee_list_share_countries() — Tool to retrieve all countries with region codes and phone codes per locale. Use when you need comprehensive country reference data including internationalization details.
- recruitee_list_share_eeo_answers() — Tool to retrieve available EEO (Equal Employment Opportunity) answers. Use when you need to see available answer options for EEO compliance questions.
- recruitee_update_candidate(name?: string, tags?: string[], email?: string, phone?: string, photo?: string, offers?: integer[], resume?: string, source?: string, candidate_id: integer, cover_letter?: string, social_links?: string[], custom_fields?: object) — Updates an existing candidate's information in Recruitee. Use this to modify candidate details such as name, contact info, cover letter, tags, and social links. All fields except candidate_id are opti
- recruitee_update_note(body?: string, pinned?: boolean, note_id: integer, candidate_id: integer) — Tool to update an existing note for a candidate. Use when you need to modify note text or pin status after creation.
- recruitee_update_offer(kind?: string, title?: string, hybrid?: boolean, remote?: boolean, status?: string, on_site?: boolean, offer_id: integer, options_cv?: string, description?: string, location_ids?: integer[], requirements?: string, department_id?: integer, options_phone?: string, options_photo?: string, locations_question?: string, visibility_options?: string[], options_cover_letter?: string, locations_question_type?: string, locations_question_required?: boolean) — Updates an existing job offer or talent pool in Recruitee. Allows modification of offer details including title, description, requirements, status, locations, department assignment, work type (remote/

## Example prompts
- "What can I do in Recruitee?"
- "Show me a summary of my Recruitee account"

## Links
Docs: https://mcp.ai/docs/mcps/recruitee
Website: https://mcp.ai/mcps/recruitee