What is Recruiterflow MCP?
Recruiterflow's MCP (Model Context Protocol) integration lets you connect your Recruiterflow account directly to AI assistants like Claude. Once connected, you can search your candidate database, pull up job details, review pipelines, and read candidate activity, all from inside your AI chat, without switching tabs or logging into Recruiterflow separately.
Think of it as giving Claude a live window into your Recruiterflow account.
What Claude Can See Today
The integration now covers most of what you'd look up manually in Recruiterflow:
Candidates — name, location, current title and company, tags, custom fields, current pipeline stage, jobs attached, and who owns or added the record
Jobs — name, visibility (external, internal, confidential, draft, closed), client company, and status
Pipeline — the full stage-by-stage breakdown for a job, including timestamps and disqualification reasons
Activities — notes, calls, emails, and meetings logged against a candidate (job and company-level activity are not yet included)
Reference data — team members, pipeline stages, and client companies, so Claude can resolve names like "Sarah" or "Acme Capital" to the right record
The integration is read-only — Claude can query this data but cannot create, edit, delete, or merge anything in your account. Think of it as a reporting layer, not an editing one.
What You Need Before You Start
An active Recruiterflow account
A Claude Pro, Team, or Enterprise subscription (the Connectors feature is not available on the free plan)
How to Connect
On Claude.ai (web):
Go to claude.ai or Claude desktop app and open Settings
Navigate to Connectors
Click Add in the top right corner, and select Add custom connector to add a new custom connector
Fill in the following:
Name: Recruiterflow
Remote MCP server URL:
https://recruiterflow.com/api/mcpOAuth Client ID:
claude-web(optional)
Click Add
Click Connect on the Recruiterflow connector that appears
You'll be redirected to Recruiterflow — log in with your Recruiterflow credentials
Click Allow on the consent screen
Done. Open a new chat and you're ready to go.
Note: Authentication uses OAuth 2.1. Recruiterflow never stores your Claude credentials, and Claude never stores your Recruiterflow password. You're authorising a secure, read-only connection between the two.
Example Prompts to Try
Once connected, here are some things you can ask Claude:
Look things up, without opening Recruiterflow:
"Find candidate Tony Stark"
"Show me candidates in Bengaluru or Mumbai with 'React' in their tags"
"Who's currently in the Interview stage of the Backend Engineer job?"
"List all open jobs for Acme Capital"
Ask for the analysis directly:
"Break down every candidate on this job by lead owner and stage - [job name]"
"Rank disqualification reasons on this job by frequency - [job name]"
"How many candidates does each recruiter currently own across every open job?"
Connect the output to other tools:
"Turn this job's pipeline breakdown into a table I can drop into a client report"
"Summarize this candidate's full activity history into a one-paragraph brief before my call"
Name search matches partial names too — "Tony" will find "Tony Stark," so you don't need the full name to get a hit.
Data & Privacy
The integration is read-only. Claude can retrieve data from Recruiterflow but cannot create, edit, or delete anything.
Access is scoped to your account. Claude can only see data that your Recruiterflow user account has permission to access.
You can disconnect the integration at any time from Claude Settings → Connectors.
Troubleshooting
Claude says it can't find candidates I know exist.
Try a shorter or more specific search term — a first name or a distinctive part of the name usually works better than the full name. If you're searching by location, note that "Bengaluru" and "Bangalore" are treated as different values, so try both.
Claude can't filter jobs by status.
Job status filtering (open vs. closed) is being rolled out — for now, ask Claude to list all jobs matching a name or company and it will show you the status for each so you can scan for what you need.
I'm getting a connection error after setting up.
Try disconnecting and reconnecting from Claude Settings → Connectors. If the issue persists, contact Recruiterflow support.
The Connectors option isn't visible in my Claude settings.
Connectors require a Claude Pro, Team, or Enterprise subscription. The free plan does not support custom connectors.
What's Coming Next
We're actively expanding the MCP integration based on customer requests. Upcoming capabilities include:
Stable job status filters (open/closed) with consistent sorting
Notes and activity coverage beyond candidates — jobs and companies
Bulk pipeline reads across multiple jobs in a single request
Real-time updates via webhooks, instead of Claude having to ask again for the latest data