Zoho Recruit
The Zoho Recruit connector lets AI agents manage the full hiring pipeline — browsing candidates and job openings, creating new records, and scheduling interviews. It uses OAuth 2.0 so your credentials are stored encrypted in MCPGate's vault and are never exposed to the AI client.
Required scopes#
MCPGate requests the following OAuth scopes when you connect a Zoho Recruit account.
| Scope | Purpose |
|---|---|
| ZohoRecruit.modules.ALL | Read and write candidates, jobs, interviews, and other ATS modules |
| ZohoRecruit.settings.ALL | Read department and configuration metadata |
Tool reference#
The Zoho Recruit connector exposes 12 tools. Use the MCP Apps page to enable or disable individual tools per app, and the Guardrails page to add fine-grained rules on top.
| Tool | Category | Description |
|---|---|---|
| zohorecruit_list_candidates | read | List candidates in Zoho Recruit |
| zohorecruit_get_candidate | read | Get details of a specific candidate by ID |
| zohorecruit_list_jobs | read | List job openings in Zoho Recruit |
| zohorecruit_get_job | read | Get details of a specific job opening by ID |
| zohorecruit_list_interviews | read | List scheduled interviews in Zoho Recruit |
| zohorecruit_list_clients | read | List clients in Zoho Recruit |
| zohorecruit_list_departments | read | List departments in Zoho Recruit |
| zohorecruit_search_candidates | read | Search candidates by criteria in Zoho Recruit |
| zohorecruit_create_candidate | write | Create a new candidate record in Zoho Recruit |
| zohorecruit_update_candidate | write | Update an existing candidate record in Zoho Recruit |
| zohorecruit_create_job | write | Create a new job opening in Zoho Recruit |
| zohorecruit_schedule_interview | write | Schedule an interview for a candidate in Zoho Recruit |
No delete tools
full_access preset without risk of removing ATS records.Common guardrail recipes#
Read-only access#
Apply the read_only preset to enable the eight read tools and deny all write tools. Suitable for recruiting analytics agents that summarise pipeline health, candidate counts, and time-to-hire metrics without modifying any records.
Recruit preset#
Use the recruit preset to enable all 12 tools. This gives recruiting agents the full workflow — sourcing and creating candidate profiles, posting jobs, and scheduling interviews.
Restrict to specific departments#
Apply a allow_values guardrail to zohorecruit_create_job targeting the department_id field with department IDs the agent is permitted to post openings for. Use zohorecruit_list_departments to retrieve the IDs.
Troubleshooting#
- Candidate stage required— Zoho Recruit tracks candidates through pipeline stages. When creating or updating a candidate, provide a valid stage name (e.g. "New", "Screening", "Interview") to ensure the record appears in the correct pipeline view.
- Interview scheduling requires candidate and job IDs —
zohorecruit_schedule_interviewrequires both a candidate ID and a job opening ID. Ensure both records exist before calling this tool. - Custom fields — Zoho Recruit organisations frequently add custom fields to candidate and job modules. The connector passes custom fields through the API payload as additional key-value pairs. Consult your Zoho Recruit admin for custom field API names.