How to integrate Zoho Recruit MCP with Atomic Agent

Connect Atomic Agent to Zoho Recruit MCP. List candidates for open engineering roles, show interviews scheduled for next week, and more using natural language, with authentication handled for you.

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

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Zoho Recruit.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Zoho Recruit account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Zoho Recruit with

How Atomic Agent connects to Zoho Recruit

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Zoho Recruit to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Zoho Recruit. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Zoho Recruit account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Zoho Recruit MCP server, and what's possible with it?

The Zoho Recruit MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Zoho Recruit account. It provides structured and secure access to your candidates, job openings, applications, hiring pipelines, notes, and recruitment files, so your agent can create and manage records, connect candidates with jobs, track hiring progress, and organize recruitment work on your behalf.

  • Recruiting record management: Have your agent create, find, review, update statuses for, and delete candidate, application, and job-opening records.
  • Candidate and job coordination: Let the agent associate candidates with job openings, submit candidates to hiring managers or client contacts, and add notes to recruiting records.
  • Hiring pipeline tracking: Direct your agent to review pipeline transitions and history, change job-opening pipelines, create stages, and manage stage or status changes.
  • Candidate evaluation: Instruct your agent to create assessments and reviews, including feedback from candidates, recruiters, or interviewers.
  • Recruitment file and workspace organization: Have your agent list, download, or delete attachments and photos, manage tags, inspect custom views and fields, and review organization, role, and profile details.

Use Zoho Recruit from Atomic Agent

With your account connected, ask Atomic Agent to work with Zoho Recruit in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

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.

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