X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Recruitee to Claude

Connect Claude Web, Desktop and Cowork to Recruitee MCP. Add a new candidate named alex lee, list all currently published job offers, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Recruitee logoRecruitee
Api KeyOauth2

Recruitee is collaborative hiring software that centralizes recruitment tasks for teams. It streamlines sourcing, interviewing, and hiring so you can fill roles faster.

23 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Recruitee account to Claude via Composio Connect, enabling it to add a new candidate named Alex Lee, list all currently published job offers, get detailed profile for candidate Emily Chen, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Recruitee with

Claude CodeOpenAI Agents SDKClaude Agent SDKCodexOpenClawHermesAtomic AgentGoogle ADKLangChainVercel AI SDKMastra AILlamaIndexCrewAIPydantic AIAutoGen

Connecting Recruitee to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Recruitee account

Back in Claude, ask it to connect to Recruitee or give it any Recruitee-related task.

For example, ask Claude to:

  • "Add a new candidate named Alex Lee"
  • "List all currently published job offers"
  • "Get detailed profile for candidate Emily Chen"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Recruitee account is ready to use.

What is the Recruitee Claude Connector, and what's possible with it?

The Recruitee MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Recruitee account. It provides structured and secure access to your recruitment workflow, so your agent can perform actions like managing candidates, creating notes, publishing job offers, retrieving company info, and handling tags on your behalf.

  • Automated candidate management: Quickly create new candidate profiles, retrieve detailed information, or delete candidates as your hiring process evolves.
  • Collaborative note-taking: Let your agent add notes to candidate profiles, ensuring every piece of feedback or interview insight is captured and accessible.
  • Job offer publishing and retrieval: Effortlessly generate new job offers or fetch details on published positions from your public careers site.
  • Company and job listing access: Instantly get your company ID, list all candidates, or pull a list of current published job offers for reporting and coordination.
  • Tag and label management: Enable your agent to delete outdated tags, keeping your recruitment database organized and relevant.

Troubleshooting

1. Why does Claude not use the Composio connector for Recruitee?

The connector can show as connected, but Claude must use it in each Recruitee conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Recruitee again.

2. Why does Claude show an MCP server error before Recruitee connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Recruitee.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Recruitee.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Recruitee authorization link not work?

The Composio connector is one server. Your Recruitee account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Recruitee connection.
  • Composio creates a fresh Recruitee authorization link.
  • Open that link in your browser and finish the Recruitee sign-in.

4. Why do Recruitee actions fail after they worked before?

The Recruitee connection can expire or lose permission.

  • Ask Claude to inspect the Recruitee connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Recruitee account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Recruitee.
  • If the action still fails with a permission error, check that the connected account has that permission in Recruitee itself.

5. How do I switch to a different Recruitee account?

Claude can manage the Recruitee connection for you.

  • Ask Claude to disconnect or delete the current Recruitee account.
  • Ask Claude to connect Recruitee again.
  • Open the new Composio authorization link for Recruitee.
  • Sign in with the other Recruitee account in the browser.
  • After the account connects, ask Claude to retry the Recruitee task.

6. Why is my Recruitee connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Recruitee connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Recruitee tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Recruitee.
TOOLS

Supported Tools

Every Recruitee action and event your agent gets out of the box.

Create Candidate

Tool to create a new candidate profile.

Create Note

Creates a new note for a candidate in Recruitee.

Create Offer

Creates a new job offer or talent pool in Recruitee.

Delete Candidate

Tool to delete a candidate profile.

Delete Tag

Permanently deletes a tag from Recruitee by its ID.

Get Candidate

Tool to retrieve detailed information about a specific candidate.

Get Candidates

Tool to retrieve a list of all candidates in the company.

Get Company ID

Tool to retrieve the company ID of the authenticated account.

Get Company Offer Public

Tool to retrieve a specific published job offer by ID or slug from the public Careers Site API.

Get Departments

Tool to retrieve a list of company departments.

Get Locations

Tool to retrieve a list of company locations.

Get Notes

Tool to retrieve a list of notes for a specific candidate.

Get Offers

Tool to retrieve a list of all job offers.

Get Pipeline Stages

Tool to retrieve pipeline stages of a job offer.

Get Tags

Retrieve all tags with optional filtering and pagination.

List EEO Job Categories

Tool to retrieve available EEO (Equal Employment Opportunity) job categories.

List Invoices

Tool to list invoices for a company.

List Localization Settings

Tool to retrieve localization settings including proposed time format and start day of the week.

List Share Countries

Tool to retrieve all countries with region codes and phone codes per locale.

List Share EEO Answers

Tool to retrieve available EEO (Equal Employment Opportunity) answers.

Update Candidate

Updates an existing candidate's information in Recruitee.

Update Note

Tool to update an existing note for a candidate.

Update Offer

Updates an existing job offer or talent pool in Recruitee.

FRAMEWORKS

How to build Recruitee MCP Agent with another framework

Claude Code logo

Claude Code

Use Recruitee MCP with Claude Code

OpenAI Agents SDK logo

OpenAI Agents SDK

Use Recruitee MCP with OpenAI Agents SDK

Claude Agent SDK logo

Claude Agent SDK

Use Recruitee MCP with Claude Agent SDK

Codex logo

Codex

Use Recruitee MCP with Codex

OpenClaw logo

OpenClaw

Use Recruitee MCP with OpenClaw

Hermes logo

Hermes

Use Recruitee MCP with Hermes

Atomic Agent logo

Atomic Agent

Use Recruitee MCP with Atomic Agent

Google ADK logo

Google ADK

Use Recruitee MCP with Google ADK

LangChain logo

LangChain

Use Recruitee MCP with LangChain

Vercel AI SDK logo

Vercel AI SDK

Use Recruitee MCP with Vercel AI SDK

Mastra AI logo

Mastra AI

Use Recruitee MCP with Mastra AI

LlamaIndex logo

LlamaIndex

Use Recruitee MCP with LlamaIndex

CrewAI logo

CrewAI

Use Recruitee MCP with CrewAI

Pydantic AI logo

Pydantic AI

Use Recruitee MCP with Pydantic AI

AutoGen logo

AutoGen

Use Recruitee MCP with AutoGen

FAQ

Frequently asked questions

With a standalone Recruitee MCP server, the agents and LLMs can only access a fixed set of Recruitee tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Recruitee and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Recruitee tools.

Yes, absolutely. You can configure which Recruitee scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Recruitee data and credentials are handled as safely as possible.

Start with Recruitee.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Recruitee tool your agent needs.Free to start.

Start building