MCP Server

Zoho CRM MCP

Search, retrieve, and update Zoho CRM records via your personal Zoho MCP server

Zoho's MCP service generates a personal, hosted MCP server for each user — no self-hosting required. Once you create a server in the Zoho MCP console, select Zoho CRM tools (Search Records, Get Records, Update Notes), and complete the OAuth 2.1 authorisation, you receive a unique secret URL that acts as your MCP endpoint. Paste that URL into CipherSense and your Agent nodes can search, read, and update Zoho CRM records directly. The URL embeds your auth token — no additional headers are needed.

Official documentation

Setup

Create a Zoho MCP server

Go to the Zoho MCP console, click Create, and give your server a name. Zoho generates a unique, hosted MCP server endpoint for your account.

Zoho MCP console

Add Zoho CRM tools and authorise

Inside your new server, add the Zoho CRM service and select the tools you need (e.g. Search Records, Get Records, Update Notes). Zoho will prompt you to complete an OAuth 2.1 authorisation screen — click Accept to grant the required permissions. This step must be completed before the endpoint will respond to tool calls.

Copy your unique MCP server URL

Navigate to the Connect tab of your Zoho MCP server. Click the copy button next to your unique MCP URL. Treat this URL as a secret — it contains your embedded auth token and grants full access to the tools you configured.

Add the integration in CipherSense Agents

Go to Project > Integrations > Add Integration > Zoho CRM MCP. Paste your unique Zoho MCP URL into the endpoint field and click Save & Test.

Use in a workflow

Add a Zoho CRM MCP node to your workflow canvas. Select a tool from the auto-discovered list and map parameters from upstream nodes — for example, pass a contact email to Search Records and wire the result into an Agent node.

Connection Fields

Fields required when adding this integration in your Project › Integrations.

Field	Required	Description
Zoho MCP Server URL	Required	Your unique Zoho MCP server URL from the Connect tab. This URL embeds your auth token — treat it as a secret and regenerate it from the Zoho console if compromised.

Common Use Cases

Search CRM contacts and leads by criteria for AI enrichmentFetch deal and account records to feed into Agent decision logicUpdate CRM notes automatically after an AI call or meeting summarySync inbound form data (e.g. from Tally) directly into Zoho CRM contactsTrigger CRM record lookups from support or sales workflow pipelines

Available Tools

Tools exposed by this MCP server and available to Agent nodes in your workflows.

Get_OrganizationGet_ModulesGet_ModuleGet_FieldsGet_LayoutsGet_LayoutGet_UsersGet_UserSearch_RecordsGet_RecordsGet_RecordexecuteCOQLQueryCreate_RecordsUpdate_RecordUpdate_RecordsUpsert_RecordsDelete_RecordDelete_RecordsCreate_FieldCreate_NotesUpdate_NotesDelete_NotesUpdate_UsersUpdate_UsergetTimelinesAdd_Tags_To_Multiple_RecordsgetBulkReadJobDetailsgetVariablesgetVariableByIdputVariableByIdGet_TagsCreate_TagsgetAssignmentRulesgetRelatedListsupdateRelatedRecordsgetRelatedRecordsgetRelatedRecorddelinkRelatedRecordupdateSpecificRelatedRecordgetAllTerritoriesconvertInventory

Common Errors

Known errors and how to resolve them.

401 Unauthorized / 403 ForbiddenTest Connection

Why this happens

The MCP URL has been regenerated in the Zoho console since it was last saved, invalidating the stored URL.

How to fix

Go to the Connect tab in your Zoho MCP console, copy the current URL, and update the integration in CipherSense.

tools/list returned empty arrayWorkflow Execution

Why this happens

No tools have been added to the Zoho MCP server, or the OAuth authorisation was not completed for the Zoho CRM service.

How to fix

Return to the Zoho MCP console, confirm Zoho CRM tools are added, and complete the OAuth authorisation step if not already done.

Connection timeoutTest & Execution

Why this happens

The Zoho MCP server URL is incorrect or the server has been deleted in the Zoho console.

How to fix

Verify the URL in the Zoho MCP console Connect tab is identical to what is saved in CipherSense. Re-create the server if it was deleted.

Ready to connect Zoho CRM MCP?

Add this integration from your project dashboard and wire it into a workflow.

Open Dashboard ← Back to Integrations