Recruitee
Recruitee is a collaborative hiring software that streamlines recruitment processes, enabling teams to source, interview, and hire candidates efficiently.
Verdict
Common use cases
- Triage new applicants during morning standup
- Pull candidate profiles before interview calls
- Add interview feedback notes from chat
- Draft and send offer letters collaboratively
- Archive withdrawn candidates in bulk
Integration
- Vendor
- Recruitee
- Category
- other
- Auth
- API_KEY
- Tools
- 20
- Composio slug
recruitee
Tools
- Create Candidate
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."
- Create Note
Tool to create a new note for a candidate. use after confirming this detail.
- Create Offer
Tool to create a new job offer. use after confirming all offer details and ready to publish.
- Delete Candidatedestructive
Tool to delete a candidate profile. use when you need to permanently remove a candidate from your recruitee account. returns no content on success.
- Delete Tagdestructive
Tool to delete a tag. use when you need to permanently remove a tag from recruitee. use after confirming the tag is not in use.
- Get Candidate
Tool to retrieve detailed information about a specific candidate. use when you need the candidate's full profile before proceeding.
- Get Candidates
Tool to retrieve a list of all candidates in the company. use when you need to fetch or filter candidates before proceeding.
- 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.
- Get Company Offer Public
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.
- Get Company Offers Public
Tool to get a list of published company jobs from the careers site api. use when you need to list all current published offers.
- Get Departments
Tool to retrieve a list of company departments. use when you need to reference or assign offers or candidates to departments.
- Get Locations
Tool to retrieve a list of company locations. use when you need to see all location options before assigning them to offers.
- Get Notes
Tool to retrieve a list of notes for a specific candidate. use after confirming the candidate exists when you need to review their notes.
- Get Offer
Tool to retrieve detailed information about a specific job offer. use when you have the offer id and need its full metadata.
- Get Offers
Tool to retrieve a list of all job offers. use after authentication to browse or paginate your company's complete set of offers.
- Get Pipeline Stages
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."
- Get Tags
Tool to retrieve a list of all tags. use after authenticating to fetch or search tags by name or usage count.
- Update Candidate
Tool to update information for an existing candidate. use when you need to modify a candidate's profile after retrieval.
- Update Note
Tool to update an existing note for a candidate. use when you need to modify note text or pin status after creation.
- Update Offer
Tool to update information for an existing job offer. use when you need to modify an offer's details after retrieval.
Setup
Setup guide
- 11. In Switchy, open the Space where you want to use Recruitee and click the integrations menu in the sidebar. 2. Select 'Add MCP Integration' and choose Recruitee from the list. 3. Log in to your Recruitee account, navigate to Settings > API Keys, and generate a new key with read and write permissions for candidates, offers, and notes. 4. Paste that key into the Switchy prompt and click Connect. 5. Switchy will confirm the connection by retrieving your company ID. 6. Test it by typing '@Recruitee get candidates' in the Space — you should see a list of recent applicants. 7. From now on, @mention Recruitee in any message to invoke its tools; the AI will route your request to the right endpoint and display results inline.
What teammates see: by default, memories from Recruitee are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.
Works well with
Top models
Compatibility data appears once enough Spaces have used this MCP together with a given model.
How Switchy teams use it
Starter prompts
List Recent Applicants
@Recruitee get all candidates who applied in the past 7 days and show their names, emails, and current stage.Open in a Space →
Prep Interview Packet
@Recruitee retrieve the full profile for candidate ID 12345 including all notes and application history.Open in a Space →
Log Interview Feedback
@Recruitee create a note for candidate jane.doe@example.com: 'Strong technical skills, good culture fit, recommend moving to final round.'Open in a Space →
Create Candidate from Resume
@Recruitee create a new candidate named Alex Chen, email alex.chen@example.com, applying for Senior Engineer role.Open in a Space →
Draft Job Offer
@Recruitee create an offer for candidate ID 67890: $120k salary, start date March 1, remote position.Open in a Space →
Example outputs
Illustrative - representative of the model's voice and quality, not literal recordings.
@Recruitee show me all candidates who applied in the last 7 days and are currently in the 'Phone Screen' stage
Based on your Recruitee account, here are 12 candidates who applied within the last week and are at the Phone Screen stage: Sarah Chen (applied 2 days ago, Software Engineer role), Marcus Williams (applied 4 days ago, Product Manager role), and 10 others. The list includes their application dates, current stage, assigned recruiter, and most recent activity. Would you like me to pull full profiles for any of these candidates or filter further by specific job openings?
This example shows the MCP's ability to filter candidates by date range and pipeline stage. Requires API key with read access to candidates. The actual response structure depends on your account's custom fields and stage names — this output is illustrative of what a typical query returns.
@Recruitee create a new candidate profile for Alex Rivera, email alex.rivera@example.com, applying for Senior Designer position
I've created a new candidate profile in Recruitee for Alex Rivera (alex.rivera@example.com) and associated them with the Senior Designer opening. The profile is now visible in your candidate pipeline at the 'New Applicants' stage. Candidate ID is 847392. You can add a resume, notes, or move them to the next stage whenever you're ready. Should I add any initial notes or tags to this profile?
This demonstrates the MCP's write capability to add candidates directly from a Space conversation. Side-effect: the candidate immediately appears in your Recruitee dashboard and may trigger notification workflows if configured. Requires API key with candidate creation permissions. You'll typically want to attach a resume or LinkedIn profile afterward.
@Recruitee pull the profiles for all candidates in 'Final Interview' stage and draft a summary comparing their experience levels for the Backend Engineer role
I retrieved 5 candidates currently in Final Interview for Backend Engineer. Here's a comparative summary: Two senior-level candidates (8+ years: Maria Santos with distributed systems background, James Park with fintech experience), two mid-level (4-6 years: both strong in Python/Go), and one junior candidate (2 years, recent bootcamp grad with impressive side projects). Maria and James have the deepest architectural experience, while the mid-level candidates show stronger collaboration skills based on interview notes. All five have passed technical assessments. Would you like me to pull specific interview feedback or create offer comparison scenarios?
This example pairs the MCP's candidate retrieval with AI reasoning to synthesize hiring insights. The summary quality depends on how much detail your team has logged in Recruitee (interview notes, tags, custom fields). Useful for hiring committee prep, but always verify critical details in the source system before making decisions.
Use-case deep-dives
When Recruitee MCP speeds up batch candidate entry
A 6-person startup runs a two-week hiring sprint and collects 40 resumes from a conference booth. The team wants to bulk-create candidate profiles in Recruitee without clicking through the web UI 40 times. The MCP's Create Candidate tool handles this: you feed it name and email pairs, and it writes profiles in seconds. The trade-off is that you lose the web form's validation guardrails—if your data is messy (duplicate emails, malformed names), you'll create junk records. This works when your intake data is clean and you need speed over hand-holding. If you're triaging one or two candidates a day, the web UI is faster than writing prompts.
Why this MCP fits post-interview note capture
A 10-person agency runs interviews in Zoom, then debriefs in a Slack thread. The hiring manager wants those notes attached to the candidate's Recruitee profile without copy-paste. The MCP's Create Note tool takes the Slack thread text and writes it to the candidate record in one step. The boundary: if your notes include attachments or structured scorecards, the MCP only handles plain text—you'll need to upload files manually. This is a win when your debrief is conversational and you want it logged fast. If your process requires formatted feedback forms, stick to Recruitee's native note templates.
When Recruitee MCP handles multi-candidate offer rollout
A 15-person tech team hires three engineers in the same week and needs to generate offer letters with identical terms but personalized details. The MCP's Create Offer tool lets you script the offer creation: loop through candidate IDs, plug in salary and start date, and publish all three offers in under a minute. The catch is that you need the candidate IDs upfront—if you're still searching by name, you'll spend time calling Get Candidates first. This pays off when you're hiring in cohorts and your offer terms are templatized. For one-off senior hires with custom negotiation, the web UI's manual flow gives you more control.
Frequently asked
What does the Recruitee MCP let me do in Switchy?
It connects your Recruitee ATS to Switchy so AI can read candidate profiles, create new applicants, add notes to pipelines, generate offers, and manage tags. You can ask questions like "show me all candidates for the engineering role" or "create an offer for Jane at $120k" without opening Recruitee. The MCP handles 20 different operations across your hiring workflow.
Do I need admin access to connect Recruitee?
You need an API key from Recruitee, which typically requires admin or owner permissions in your Recruitee account. Go to Settings > API in Recruitee to generate a key. Standard recruiter accounts usually can't create API keys. Once you paste the key into Switchy, the MCP authenticates all requests under that account's permissions.
Can the Recruitee MCP send emails to candidates?
No. The MCP reads candidate data and writes notes or offers inside Recruitee, but it doesn't trigger email sends. If you need to email a candidate, you'll still use Recruitee's built-in templates or integrate a separate email tool. The MCP is for data operations, not communication workflows.
Why use this instead of just opening Recruitee?
You can ask Switchy to pull candidate lists, compare profiles, or draft offers in natural language without switching tabs or remembering where things live in Recruitee's UI. It's faster for bulk lookups or when you're already working in Switchy with other tools. For complex pipeline moves or email sequences, you'll still want Recruitee's interface.
Who on the team should connect the Recruitee MCP?
Whoever owns your Recruitee API key—usually a recruiting ops lead or admin. That person's Recruitee permissions apply to everything the MCP does, so don't share the connection if you have recruiters who shouldn't delete candidates or see salary data. Each Switchy workspace can have one Recruitee connection.