Zoho Recruit MCP server for AI agents and assistants

Securely connect your AI agents and chatbots (Claude, ChatGPT, Cursor, etc) with Zoho Recruit MCP or direct API to manage candidates, track job openings, review applications, and coordinate interviews through natural language.

Zoho Recruit logoZoho Recruit
Oauth2

Zoho Recruit is an applicant tracking and recruitment platform for managing candidates, jobs, interviews, and applications. It helps hiring teams organize recruiting workflows and move qualified candidates through the hiring process.

62 Tools

Try Zoho Recruit now

Type what you want done — sign in and watch it run live in the Tool Router playground.

TOOL ROUTER PLAYGROUND
Zoho Recruit
Try asking
TOOLS

Supported Tools

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

Add Tags To Records

Add existing tags by name to one or up to 500 records in a Zoho Recruit module.

Associate Candidates With Jobs

Associate candidate IDs with job-opening IDs and optionally add a comment.

Cancel Interview

Cancel one scheduled Zoho Recruit interview with an optional reason and feedback.

Change Job Opening Pipeline

Assign a different hiring pipeline to one Zoho Recruit job opening and choose whether to migrate its existing stage history.

Change Offer Status

Change one Zoho Recruit Offer record's status.

Change Record Status

Change Candidate, Application, or Job Opening status for one or more record IDs.

Create Assessments

Create one or more Zoho Recruit assessment definitions, including optional sections and questions, through the v2.1 Assessments API.

Create Notes

Create one or more notes attached to Zoho Recruit records.

Create Pipeline

Create one organization-wide Job Openings hiring pipeline from existing stage and status IDs.

Create Records

Create up to 100 records in Candidates, Job Openings, Interviews, Clients, or Contacts.

Create Reviews

Create candidate, recruiter, or interviewer reviews with dynamic assessment answers.

Create Stage

Create one organization-wide Zoho Recruit hiring stage.

Create Submissions

Submit candidates or applications to a client contact or hiring manager.

Create Tags

Create one or more tags for a Zoho Recruit module.

Delete Attachment

Delete one attachment from a Zoho Recruit record.

Delete Notes

Delete one or more Zoho Recruit notes.

Delete Photo

Delete the photo from a Zoho Recruit Candidate or Contact record.

Delete Records

Delete one record or up to 100 records from a Zoho Recruit module.

Delete Stage

Permanently delete one Zoho Recruit hiring stage.

Delete Tag

Delete one tag from Zoho Recruit settings and return the provider's singular deletion outcome.

Download Attachment

Download a file attachment from a Zoho Recruit record.

Download Photo

Download the photo for one Zoho Recruit Candidate or Contact.

Get Application Pipeline Transitions

Get stage-grouped hiring-pipeline transitions for one Zoho Recruit application.

Get Custom Views

List a Zoho Recruit module's custom views or return one custom view with its criteria, sharing details, and selected fields.

Get Module Metadata

Get one Zoho Recruit module's capabilities, layouts, attachment categories, custom views, and related-list metadata.

Get Organization

Return identity, locale, currency, company, and license details for the connected Zoho Recruit organization.

Get Profiles

List Zoho Recruit permission profiles or return one profile with detailed permissions by ID.

Get Record

Get one Zoho Recruit record, including subform details, by module and record ID.

Get Roles

List all Recruit organization roles or return one role by ID.

Get Tag Record Count

Get the number of Zoho Recruit records using a tag and optionally return the areas where the tag is configured.

Import Candidate Document

Import one resume document into the Zoho Recruit candidate parser using the filename parameter and a base64-encoded multipart document field.

List Associated Records

List one page of job openings associated with a candidate or candidates associated with a job opening.

List Attachments

List attachments and linked URLs on one Zoho Recruit record.

List Deleted Records

Return one provider page of recycle-bin or permanently deleted records from a Zoho Recruit module.

List Fields

List field API names and metadata for a Zoho Recruit module across layouts.

List Hiring Pipeline History

Return one page of hiring-pipeline history for a Candidate, Application, or Job Opening.

List Modules

List modules available to the connected user with their API names, access profiles, display fields, and supported operations.

List Notes

Return one page of Zoho Recruit notes.

List Note Types

Return one page of configured Zoho Recruit note types.

List Records

Return one page of records from Candidates, Applications, Job Openings, Interviews, Clients, or Contacts in Zoho Recruit.

List Related Lists

Discover related-list API names and route templates available for a Zoho Recruit module.

List Related Records

Return one page from a named related list such as Notes, Attachments, Interviews, Contacts, or Reviews.

List Stages

Return one page of Zoho Recruit hiring stages and the statuses mapped to each stage.

List Tags

List tags configured for a Recruit module, including counts and the module's allowed tag count.

List Users

List Recruit users by status group or return the connected current user.

Merge Tags

Irreversibly merge two Zoho Recruit tags and move their associated records under the resulting tag.

Remove Tags From Records

Remove named tags from one Zoho Recruit record or up to 500 records in a module.

Review Submission

Approve or reject one Zoho Recruit submission with a rating and optional reviewer details.

Revoke Blueprint

Irreversibly remove one Zoho Recruit record from its active blueprint process.

Search Records

Search one Zoho Recruit module using exactly one selector and return one provider page of up to 49 matching records.

Transfer and Delete Pipeline

Permanently delete one Zoho Recruit hiring pipeline after transferring all of its associated stages, statuses, and records to a different pipeline.

Update Assessments

Update one Zoho Recruit assessment by path ID or multiple assessments carrying their own IDs through Recruit v2.1.

Update Notes

Update one Zoho Recruit note by ID.

Update Note Type

Rename one configured Zoho Recruit note type.

Update Pipelines

Update one Zoho Recruit hiring pipeline by path ID or update pipeline definitions carrying their own IDs through the collection route.

Update Records

Update one Zoho Recruit record by path ID or up to 100 records carrying their own IDs.

Update Reviews

Update one owned Zoho Recruit review by path ID or multiple owned reviews carrying their own IDs.

Update Stage

Rename or recolor one existing Zoho Recruit hiring stage.

Update Tag

Rename or recolor one tag in a Zoho Recruit module.

Upload Attachment

Attach either one file or one public URL to a Zoho Recruit record.

Upload Photo

Upload one image as the photo for a Zoho Recruit Candidate or Contact.

Upsert Records

Insert or update up to 100 Zoho Recruit records using duplicate-check fields in Candidates, Clients, Contacts, Job Openings, or Interviews.

SETUP GUIDE

Connect Zoho Recruit MCP Tool with your Agent

1

Install Composio

typescript
npm install @composio/core ai @ai-sdk/mcp @ai-sdk/openai
Install the Composio SDK and your agent framework
2

Create a session with MCP enabled

typescript
import { Composio } from "@composio/core";

const composio = new Composio();
const { mcp } = await composio.create("your-user-id", {
  toolkits: ["zoho_recruit"],
  mcp: true,
});
Create a session scoped to Zoho Recruit and read its MCP URL and headers
3

Connect your agent to the MCP server

typescript
import { createMCPClient } from "@ai-sdk/mcp";
import { openai } from "@ai-sdk/openai";
import { generateText, stepCountIs } from "ai";

const client = await createMCPClient({
  transport: { type: "http", url: mcp.url, headers: mcp.headers },
});

const { text } = await generateText({
  model: openai("gpt-5.6-sol"),
  tools: await client.tools(),
  prompt: "List all open job openings in Zoho Recruit and show their department, location, and number of applicants.",
  stopWhen: stepCountIs(10),
});

console.log(text);
await client.close();
Pass the session's MCP URL and headers to your agent and run a Zoho Recruit request
SETUP GUIDE

Connect Zoho Recruit API Tool with your Agent

1

Install Composio

typescript
npm install @composio/core @composio/openai openai
Install the Composio SDK, the OpenAI provider, and the OpenAI SDK
2

Create a Composio session

typescript
import OpenAI from "openai";
import { Composio } from "@composio/core";
import { OpenAIResponsesProvider } from "@composio/openai";

const composio = new Composio({ provider: new OpenAIResponsesProvider() });
const client = new OpenAI();

const session = await composio.create("your-user-id", { toolkits: ["zoho_recruit"] });
const tools = await session.tools();
Initialize Composio with the OpenAI Responses provider and create a session scoped to Zoho Recruit
3

Run Zoho Recruit tools with your agent

typescript
let response = await client.responses.create({
  model: "gpt-5.6-sol",
  tools,
  input: [{ role: "user", content: "List all open job openings in Zoho Recruit and show their department, location, and number of applicants." }],
});

while (response.output.some((o) => o.type === "function_call")) {
  const outputs = await composio.provider.handleToolCalls(session, response.output);
  response = await client.responses.create({
    model: "gpt-5.6-sol",
    tools,
    previous_response_id: response.id,
    input: outputs,
  });
}

console.log(response.output_text);
Send a request, execute the Zoho Recruit tool calls through the session, and print the final answer

Why Use Composio?

AI Native Zoho Recruit Integration

  • Supports both Zoho Recruit MCP and direct API based integrations
  • Structured, LLM-friendly schemas for reliable tool execution
  • Rich coverage for reading, writing, and querying your Zoho Recruit data

Managed Auth

  • Built-in OAuth handling with automatic token refresh and rotation
  • Central place to manage, scope, and revoke Zoho Recruit access
  • Per user and per environment credentials instead of hard-coded keys

Agent Optimized Design

  • Tools are tuned using real error and success rates to improve reliability over time
  • Comprehensive execution logs so you always know what ran, when, and on whose behalf

Enterprise Grade Security

  • Fine-grained RBAC so you control which agents and users can access Zoho Recruit
  • Scoped, least privilege access to Zoho Recruit resources
  • Full audit trail of agent actions to support review and compliance

Rolling this out across your team?

Give your team centralized access control across every framework with Composio’s MCP Gateway.

EXPLORE MCP GATEWAY
FAQ

Frequently asked questions

Start with Zoho Recruit.It takes 30 seconds.

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

Start building