Colleague Connector for Claude
How to connect Claude to Colleague and what you can ask.
← Back to User Guides
Colleague now works inside Claude. A consultant connects Claude to Colleague once, signing in with their Microsoft 365 account. From then on they can ask about their candidates, clients, contacts, jobs, interviews and placements in plain English. They can also get Colleague's AI candidate suggestions for a job, and turn an email, a Teams meeting or a web page into a new requirement or lead.
Same data, same permissions
Claude works as the signed-in consultant. It sees only the records that person can see in Colleague and follows the same rules when it creates something.
One click back to Colleague
Every candidate, company, contact, job, interview or placement Claude mentions is a link that opens the record in Colleague.
Nothing is created without a yes
Before Claude creates a requirement or lead, it shows a preview of exactly what will be added. Nothing is saved until the consultant confirms in the chat.
Works where Claude works
Claude on the web, the Claude desktop app and the Claude mobile apps, on any Claude plan.
What You Can Ask
| Area |
Try asking |
What happens |
| My work |
“What are my live jobs?” · “Show me the candidates I own who are available” |
Lists the records you own, with links. |
| Finding people and jobs |
“Find Java developers within 25 miles of LS1 4AP” · “Which candidates have worked at Rolls-Royce?” · “Contacts at Acme” |
Searches by name, place, current employer, CV text, skills and distance from a postcode, the way Colleague's Search does. |
| Candidates for a job |
“Suggest candidates for the Senior Java Developer job” |
Returns Colleague's own AI Suggested Candidates for the job, with the same ranking, scores and reasons you see in Colleague, plus a link to the full report. If AI Suggested Candidates is not switched on, Claude searches using the job's skills and description instead. |
| Shortlists |
“Who's on the shortlist for the BP role?” |
Shows the candidates already linked to that job. |
| My day |
“What have I got on today?” · “What interviews do I have next week?” |
Your Colleague tasks and diary, interviews, and candidates starting or finishing. |
| My performance |
“How am I doing this month?” · “Am I on target this quarter?” |
Your Home page dials and your targets, with the records behind a number on request. |
| Placements |
“What placements have I made in the last 30 days?” |
Recent placements with their details. |
| Saved searches |
“Save that search in Colleague” |
Creates the search in Colleague, linked to the job if it was for one, so you can shortlist or mailshot the full list there. |
| Creating jobs and leads |
“Create a requirement from this email” · “Log a lead from this article” |
Claude reads the email, Teams meeting transcript or web page and shows a preview. After you say yes, it creates the requirement or lead, plus the company and contact if they are new. The record gets a Created via Claude history entry saying where it came from. |
What It Does Not Do, and the Limits
- It does not change or delete existing records. It also cannot move candidates between stages, book interviews, send emails or mailshots, or raise invoices. Do these in Colleague.
- A single answer lists up to 50 records. For more, Claude offers to save the search in Colleague.
- Each consultant can create up to 20 records an hour through Claude. A new company, contact and job together count as 3.
- Each consultant can make up to 30 requests to Colleague a minute. Above that, Claude is asked to wait a few seconds.
- To create from an Outlook email or a Teams meeting, Claude's own Microsoft 365 connector must also be switched on for your organisation. A web page needs nothing extra.
- What Claude reads from Colleague becomes part of the Claude conversation and is covered by your organisation's agreement with Anthropic. Colleague records which features are used, never the content of a question or answer.
❗Please note - This Claude connector release represents the first phase of our integration roadmap. While the connector already provides valuable functionality, some features, capabilities, and limitations are subject to change as we gather customer feedback and continue development. We encourage users to share their experiences and suggestions to help shape future enhancements.
Before You Start
- Email addresses must match. Each consultant's email address in Colleague must be exactly the address they use to sign in to Microsoft 365. This is the most common reason the connector refuses someone, so check it before rollout.
- Your Microsoft 365 administrator approves the Colleague app once for your organisation. Colleague support sends the link.
- Colleague support enables your organisation. Send support your Microsoft 365 tenant ID. Your administrator can find it at entra.microsoft.com, under Overview.
- A Claude plan. Every plan can add the connector, but the free plan allows only one custom connector. On Team and Enterprise plans an Owner adds it once for everyone.
Setting Up Claude
| Name |
Colleague |
| Remote MCP server URL |
https://mcp.colleague7.com/mcp |
| OAuth client |
Use your own OAuth client (in some layouts this is under Advanced settings) |
| OAuth Client ID |
e9742cf8-2119-4c5b-9071-d94a7d1f6534 |
| OAuth Client Secret |
Leave blank |
Team or Enterprise plan
- An Owner goes to Organization settings > Connectors, selects Add, then Custom, then Web.
- Enter the connector details above and click Add.
- Each consultant goes to Customize > Connectors, finds Colleague (labelled Custom), clicks Connect and signs in with Microsoft 365.
Free, Pro or Max plan
- Go to Customize > Connectors and click Add custom connector.
- Enter the connector details above and click Add.
- Click Connect and sign in with Microsoft 365.
Check it works: start a new chat and ask “Who am I in Colleague?”, then “What are my live jobs?”. The first time Claude creates a record, it asks permission to use the tool. Choose Allow each time, or Always allow.
Important - Claude does not let you edit sign-in settings after the connector is added. If the URL or Client ID was entered wrongly, remove the connector and add it again, and consultants then reconnect.
Messages a Consultant May See
| Message |
What it means and what to do |
| “Your Microsoft 365 account (name@company.com) does not match a licensed Colleague user” |
The email address on the consultant's Colleague user does not match their Microsoft 365 sign-in, or the user is not licensed and active. Correct the email in Colleague. |
| “Your organisation is not enabled for the Colleague MCP server” |
Colleague support has not yet enabled this Microsoft 365 organisation. Contact support with your tenant ID. |
| “Need admin approval” on the Microsoft sign-in page |
Your Microsoft 365 administrator has not yet approved the Colleague app. Ask them to use the approval link from Colleague support. |
| “Colleague rejected the sign-in. Reconnect the Colleague connector in Claude” |
The sign-in has expired. In Customize > Connectors, disconnect Colleague and connect again. |
| “Too many Colleague requests...” |
More than 30 requests in a minute. Wait a few seconds and ask again. |
| “Colleague is scoring the candidates for this job with AI for the first time” |
The first AI suggestion for a large job can take a minute or two. Ask again shortly. |
|