How to integrate Zoho Recruit MCP with Hermes

Connect Hermes 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

Hermes is a 24/7 autonomous agent that lives on your computer or server — it remembers what it learns and evolves as your usage grows.

This guide explains the easiest and most robust way to connect your Zoho Recruit account to Hermes. You can do this through either Composio Connect CLI or Composio Connect MCP. For personal use we recommend the CLI, but you won't go wrong with MCP either.

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

Also integrate Zoho Recruit with

What is Composio Connect?

Composio Connect is a consumer offering that lets anyone plug 1,700+ applications directly into their agent harness — including Hermes. It can:

  • Search and load tools from relevant toolkits on-demand, reducing context usage.
  • Chain multiple tools to accomplish complex workflows via a remote workbench, without excessive back-and-forth with the LLM.
  • Manage app authentication end-to-end with zero manual overhead.

Integrating Zoho Recruit with Hermes

Using Composio Connect CLI

1. Install the Composio CLI

Run the install script directly, or paste https://composio.dev/hermes into your Hermes chat box to have it installed for you.

bash
curl -fsSL https://composio.dev/install | bash
Hermes authenticating with Composio

2. Authenticate

Once the CLI is installed, ask Hermes to authenticate with Composio.

3. Connect to Zoho Recruit

Ask your agent to connect to Zoho Recruit, or simply request any Zoho Recruit-related task. Hermes will prompt you to authenticate and authorize access.

4. Done. You're all set with a new Zoho Recruit connection.


Using Composio Connect MCP

1. Get your MCP URL and API Key

Go to dashboard.composio.dev and copy your Connect MCP URL and API key.

Copy MCP URL and API key from Composio dashboard

2. Open the Hermes config file

bash
nano ~/.hermes/config.yaml

3. Add the Composio Connect MCP server

bash
mcp_servers:
  composio:
    url: "https://connect.composio.dev/mcp"
    headers:
      x-consumer-api-key: "YOUR_COMPOSIO_API_KEY"
    connect_timeout: 60
    timeout: 180

Save with Ctrl + O, Enter, then exit with Ctrl + X.

4. Restart your Hermes agent

Once restarted, ask your agent to connect to Zoho Recruit or request any Zoho Recruit-related task. It will prompt you to authenticate and authorize access.

5. Done!

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.

Way Forward

With Zoho Recruit connected, Hermes can now act on your behalf whenever it detects a relevant task or you ask it to.

From here, you can extend Hermes further:

  • Connect more apps: Calendar, Slack, Notion, Linear, and hundreds of others are available through the same Composio Connect setup. Each new integration compounds what Hermes can do for you.
  • Build workflows across tools: Once multiple apps are connected, Hermes can chain actions together — turn an email into a calendar invite, a Slack message into a Linear ticket, or a meeting note into a follow-up draft.
  • Let it learn your patterns: The more you use Hermes, the better it gets at anticipating how you'd handle recurring tasks. Give it feedback on drafts and decisions, and it will adapt.

If you run into trouble or want to share what you've built, join the community or check out the Docs for deeper configuration options.

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