Skip to main content

Connecting Recruiterflow to Microsoft Copilot via MCP

Learn how to set up the integration, what you can do with it, and how to get the most out of it.

Written by Amogh Balikai

What is Recruiterflow MCP?

Recruiterflow's MCP (Model Context Protocol) integration lets you connect your Recruiterflow account directly to AI assistants like Microsoft Copilot. Once connected, you can search your candidates, companies, jobs, and deals directly, review pipelines, read candidate and contact activity, open files, check placement financials, and log or remove a note or custom activity, all from inside Microsoft Copilot, without switching tabs or logging into Recruiterflow separately.

Think of it as giving Microsoft Copilot a live window into your Recruiterflow account, the same window Recruiterflow already gives Claude and ChatGPT.

Use this integration if your agency runs on Microsoft 365 and you want your team to ask questions about candidates, jobs, and pipelines where they already work.


What Microsoft Copilot Can See (and Now Do) Today

The integration covers most of what you would 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

  • Contacts: client contact records, plus the notes, activities, tasks, and emails logged in your account

  • Jobs: name, visibility (external, internal, unlisted, confidential, draft, closed, or closed confidential), client company, status, and custom field values. Jobs are now searchable directly, not just as something attached to a candidate

  • Companies: company name, plus the jobs and contacts tied to it. Companies are now a directly searchable entity, instead of only being resolved by name when they show up through a candidate, contact, or job

  • Deals: deal name, stage, owner, and the company and contacts tied to it. Deals are now a directly searchable entity, the same way jobs and companies are

  • Pipeline: the full stage-by-stage breakdown for a job, including timestamps and disqualification reasons

  • Activities: notes, calls, meetings (summary only, not the full transcript), and emails logged against a candidate (job and company-level activity are not yet included)

  • Files: the files attached to candidates, jobs, companies, and deals, with each file's category and last-updated date. Microsoft Copilot can also read the content of those files

  • Placements and revenue: milestone value, bill rate and hours, margin, commission, and the revenue and placement data tied to a job. Placements are now directly searchable across your whole account too, not just as something attached to a job

  • Reference data: team members, pipeline stages, and client companies, so Microsoft Copilot can resolve names like "Sarah" or "Acme Capital" to the right record

Filters you can use when searching:

  • Candidates by their current stage in a specific job

  • Candidates by the stages they have passed through in a job's pipeline

  • Candidates by whether they are active in an open or closed job pipeline

  • Candidates and jobs by client company

  • Jobs by visibility (external, internal, unlisted, confidential, draft, closed, or closed confidential)

  • Jobs by custom field value (for example, a label or tag you've added to a job)

  • Companies by name

Microsoft Copilot can query this data, and it can also add or delete a note or a custom activity on a candidate, contact, job, company, deal, or placement. Beyond that, it still cannot create, edit, merge, or delete anything else in your account, and it cannot edit an existing note or activity, only add a new one or remove it.

Normal Recruiterflow permissions apply. Microsoft Copilot only sees what your user account is allowed to see, including placement and revenue data.

This is the same data set the Claude and ChatGPT integrations expose today.


Adding and Deleting Notes & Activities

Microsoft Copilot can now add a note or a custom activity to a record, and delete one too, the first actions in this integration that go beyond search. Everything else stays read-only.

  • A note or activity added by Microsoft Copilot shows up in the record's activity timeline just like one you added yourself

  • Deleting a note or activity removes it for good, so double check before asking Microsoft Copilot to delete one

  • Microsoft Copilot can't edit an existing note or activity. To change one, delete it and add a new one


What You Need Before You Start

  • An active Recruiterflow account

  • A Microsoft 365 account with access to Microsoft Copilot

  • A Microsoft 365 admin who can make the Recruiterflow app available to your team


How to Connect

Connecting happens in two parts: a Microsoft 365 admin makes the app available, then each user signs in to Recruiterflow.

Part 1: Admin makes the Recruiterflow app available

  1. Open the Microsoft 365 admin center and go to Settings.

  2. Select Integrated apps.

  3. Search for Recruiterflow in the Microsoft Marketplace.
    ​

  4. Click Get app and review the permissions.

  5. Choose who gets access: everyone, specific users, or specific groups. Start with a small group if you want to pilot first.

  6. Click Deploy.

Part 2: Each user connects their Recruiterflow account

  1. Open Microsoft Copilot and find the Recruiterflow app.

  2. Ask a question about your Recruiterflow data, or select Connect when prompted.

  3. Log in with your Recruiterflow credentials when you are redirected to Recruiterflow.

  4. Click Allow on the consent screen.

  5. Return to Microsoft Copilot and start asking questions.

Note: Authentication uses OAuth 2.1. Recruiterflow never stores your Microsoft credentials, and Microsoft Copilot never stores your Recruiterflow password. You are authorising a secure connection between the two.


Example Prompts to Try

Once connected, here are some things you can ask Microsoft Copilot:

Look things up, without opening Recruiterflow:

  • "Find candidate Tony Stark"

  • "Show me candidates in London or Manchester with 'React' in their tags"

  • "Who's currently in the Interview stage of the Backend Engineer job?"

  • "List all open jobs for Acme Capital"

  • "Show me the notes, tasks, and emails for [contact name]"

  • "Which files are attached to [candidate name], and which one is the latest resume?"

  • "Pull up the company Acme Capital directly, even if I don't know a job or contact there"

  • "Which jobs have the custom field 'Key Accounts' set?"

  • "Find all deals tied to Acme Capital"

  • "Pull up this placement directly, even if I don't have the job name handy"

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?"

  • "Show the bill rate, margin, and commission on each placement for [job name]"

Log or clean up records directly:

  • "Add a note on [candidate name]: Spoke with them today, strong fit for the Backend Engineer role"

  • "Log a custom activity on [contact name] for the intro call we just had"

  • "Delete the note I added on [candidate name] an hour ago, I made a typo"

Connect the output to your Microsoft 365 tools:

  • "Turn this job's pipeline breakdown into a table I can paste into a client update email"

  • "Summarize this candidate's full activity history into a one-paragraph brief before my call"

  • "Read this candidate's resume and turn it into a one-page profile I can send to a client"

Name search matches partial names too. "Tony" finds "Tony Stark", so you do not need the full name to get a hit.


Admin Controls for MCP

Account admins control MCP access for the whole team from Settings → Integrations → AI assistants (MCP) in Recruiterflow. This is an account-level setting, so only admins can change it, not individual users.

  • The main AI assistants (MCP) toggle turns the entire MCP integration on or off for the account. When it's off, no one on the team can read or write Recruiterflow data through Microsoft Copilot, Claude, or ChatGPT, regardless of whether they've connected their own account.

  • With MCP turned on, a second toggle, Allow changes, controls whether AI assistants can write at all. When this is on, assistants can add notes and custom activities, and delete them after the user confirms. When it's off, the integration is read-only for everyone, so Microsoft Copilot can search and read data but cannot add or delete anything. By default, this will be toggled off.

If you're connected but can't get Microsoft Copilot to add or delete a note or activity, check with your Recruiterflow admin that Allow changes is turned on.


Data & Privacy

  • Microsoft Copilot can retrieve data from Recruiterflow, and can add or delete a note or a custom activity, but cannot create, edit, merge, or delete anything else.

  • Access is scoped to your account. Microsoft Copilot can only see data that your Recruiterflow user account has permission to access. This includes files, contacts, and placement and revenue data.

  • You can disconnect at any time.


Troubleshooting

I can't find the Recruiterflow app in Microsoft Copilot.

Your Microsoft 365 admin needs to deploy the app to your user or group first. Ask your admin to check that your account is included in the deployment, then restart Microsoft Copilot.

I'm stuck on the Recruiterflow login or consent screen.

Make sure you are logging in with your Recruiterflow credentials, not your Microsoft ones. If the screen does not load, clear your browser session, then try again. If the issue persists, contact Recruiterflow support.

Microsoft Copilot 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 are searching by location, "New York" and "NY" are treated as different values, so try both.

Microsoft Copilot can't filter jobs by status.

You can filter jobs by visibility, which includes closed and closed confidential. For open vs. closed status, ask Microsoft Copilot to list all jobs matching a name or company. It shows the status for each job, so you can scan for open or closed roles.

Microsoft Copilot doesn't show placement or revenue data.

This data follows your Recruiterflow permissions. If you can't see revenue or placement details on a job in Recruiterflow, Microsoft Copilot can't see them either. Ask your Recruiterflow admin to check your role.

I'm getting a connection error after setting up.

Disconnect and reconnect the Recruiterflow app, then try again. If the error continues, contact Recruiterflow support.


Did this answer your question?