How to Connect Cursor to Zoho CRM (2026): Link, mcp.json

By Ira Bodnar, Ryze AI · Updated November 13, 2026

Quick answer

To connect Cursor to Zoho CRM, click Connect on the Zoho CRM card in Ryze AI and approve access in Zoho, then add https://connector.get-ryze.ai/mcp to Cursor with the Add to Cursor link or a url entry in mcp.json, and sign in when Cursor asks.

In Ryze AI open Integrations, click Connect on Zoho CRM and sign in to Zoho
Approve access to CRM modules, settings, users and organization details
In Cursor add the Ryze AI server (Add to Cursor link or mcp.json) and finish the sign-in
Start a new Cursor chat, approve the tool call and ask about your CRM records

Before you start

A Cursor install. Cursor's MCP documentation names no plan for using MCP servers. On Enterprise, admins can control which MCP servers users may run in Team Settings > MCP Configuration, so a blocked server needs an admin to allow it.
A Zoho account that can approve CRM access. You sign in to Zoho from Ryze AI and approve access to CRM modules, settings, users and organization details. Any Zoho data center works (US, EU, India, Australia and others). There is no key to create or paste.
A Ryze AI workspace on a plan or free trial. Paid Ads is $89 per month with a 7-day free trial; the Zoho CRM tools also work on SEO Starter ($129 per month, 3-day free trial) and Agency ($279 per month). Adding the connector is free, but the Zoho CRM tools need an active plan or trial.

How to connect Cursor to Zoho CRM

Two steps happen in Ryze AI and Zoho, two in Cursor, and one when you ask. The connector URL is the same for every user.

Connect Zoho CRM in Ryze AI
Create a Ryze AI account or sign in, open Integrations, find the Zoho CRM card (CRM filter) and click Connect. Sign in to Zoho; any data center works.
Approve the Zoho access
Approve access to CRM modules, settings, users and organization details. The card then shows Connected, and View shows the organization name. Access renews automatically.
Add the Ryze AI server to Cursor
Pick one route. The Add to Cursor button above, or the one on the Ryze AI developers page, opens a cursor:// install link that registers a server called ryze pointing at https://connector.get-ryze.ai/mcp. The other route is a file: ~/.cursor/mcp.json covers every project, .cursor/mcp.json covers a single project, and either takes the url entry below.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }
Sign in from Cursor
Accept the install prompt in Cursor. The sign-in is OAuth with PKCE and dynamic client registration, so no client ID or secret is requested. A Ryze AI page opens: log in and press Allow connection. The Customize page in Cursor's sidebar lets you toggle the server afterwards.
Ask your first question in Cursor
Open a fresh Cursor chat, say yes when the tool call prompt appears, and send: List the fields of my Leads module in Zoho CRM.

The Ryze AI help center page for Zoho CRM covers the Zoho CRM side of the connection. Cursor does not have its own Ryze AI help page; the Ryze AI developers page has the Add to Cursor link and the matching config.

Sources: Cursor MCP documentation, Ryze AI Zoho CRM guide. Checked November 13, 2026.

mcp.json, API key and Cloud Agents

mcp.json

A remote server needs only a url field in Cursor's config file. Put the entry in ~/.cursor/mcp.json to use it everywhere, or in .cursor/mcp.json inside one repository. Cursor then runs the OAuth sign-in on its own.

{
  "mcpServers": {
    "ryze": {
      "url": "https://connector.get-ryze.ai/mcp"
    }
  }
}

Cursor speaks stdio, SSE and Streamable HTTP. For OAuth it follows the protected resource metadata the server publishes (RFC 9728) and registers as a public client by dynamic registration. Once signed in, the Customize page in the sidebar shows the server.

mcp.json with a Ryze AI API key

A Ryze AI key can replace the browser sign-in. Add the headers entry shown, and export RYZE_API_KEY with the rk_live_ key from Workspace Settings > Profile > API keys in Ryze AI. Zoho CRM still connects through the Zoho sign-in on its card. Never commit the key.

{
  "mcpServers": {
    "ryze": {
      "url": "https://connector.get-ryze.ai/mcp",
      "headers": {
        "Authorization": "Bearer ${env:RYZE_API_KEY}"
      }
    }
  }
}

Cloud Agents

A Cursor Cloud Agent stores MCP sign-ins on Cursor's servers, apart from your desktop login. When a cloud run must read the CRM, add the Ryze AI server for that agent too.

Claude and ChatGPT

The same URL works in other MCP clients. Zoho CRM is connected once in Ryze AI, so nothing changes on the Zoho side.

Claude

Use https://connector.get-ryze.ai/mcp as a custom connector (Customize > Connectors), select the workspace, open a new chat. Added the connector before Zoho CRM? Remove and re-add it.

ChatGPT

Add the same URL as an app in Settings > Apps and select the workspace. Zoho CRM connected later? Re-add the app so the tool list refreshes.

Zoho CRM access and scopes

Two sign-ins are involved: a Zoho sign-in for CRM access and Ryze AI for the connector. Three things decide what Cursor can reach.

Which organization: The Zoho CRM organization you signed in to. You can connect several Zoho CRM organizations to one workspace (View > Add one more account). One is the primary and is used unless you name another, and the tools accept an optional connection_id.
What Cursor can change: The tool set includes write and delete tools, so Cursor can create, update, upsert and delete records when you ask. Deleted records go to the Zoho CRM recycle bin. Ryze AI does not document changes to CRM settings or module configuration, so treat the connection as record-level access.
What Cursor asks first: By default Cursor stops for your approval before an MCP tool runs, using the Run Modes that govern terminal commands. A record update or delete therefore waits for you, unless you allowlist that tool.

The Zoho scopes

The Zoho sign-in asks for the OAuth scopes below, as listed in the Ryze AI documentation.

OAuth scope	What it allows
ZohoCRM.modules.ALL	Read and write records in CRM modules
ZohoCRM.settings.ALL	Read CRM settings such as modules and fields
ZohoCRM.users.READ	Read CRM users
ZohoCRM.org.READ	Read organization details
ZohoCRM.coql.READ	Run COQL queries

Removing access

To remove access, click View on the Zoho CRM card in Ryze AI and disconnect it, or revoke the Ryze AI authorization from your Zoho account. In Cursor, toggle the ryze server off from Customize or delete its entry from mcp.json.

What Cursor can do in Zoho CRM

The Ryze AI connector exposes four Zoho CRM tools: two read, one write and one delete.

Tool	Type	What it does
zoho__read	Read	Sends a GET request to any Zoho CRM API resource, such as module records, a single record, module settings, fields or users.
zoho__query	Read	Runs a COQL query (SQL-like select over CRM modules), up to 2,000 rows per call.
zoho__write	Write	Creates, updates or upserts Zoho CRM records, up to 100 records per call.
zoho__delete	Delete	Deletes Zoho CRM records singly or in bulk. Deleted records go to the Zoho CRM recycle bin.

List calls need the field names to return, because Zoho rejects list calls without them. Past 2,000 records, page-based pagination stops and a page token is needed. A 200 response from a write can still hold per-record errors, so ask Cursor to check each record in the result. The tools work only while the Ryze AI workspace has an active plan or free trial.

Cursor's default is to ask first, which lets you review each change. The Ryze AI chat is a different place with its own Tool approvals setting. It starts on Skip all approvals, so Zoho CRM tools run without a prompt there until you pick Approve write & delete or Manual approve. Scheduled tasks have no approval step.

First 3 prompts to run

1. Inspect a module before you query it

List the fields of the Leads module in my Zoho CRM, with each API name and field type.

Tools used: zoho__read

What comes back: A list of Leads fields as plain text in Cursor. Nothing in Zoho CRM is changed, and the API names are what you use in later queries.

2. Run a COQL query

Run a COQL query on Deals for open deals created this quarter, selecting Deal_Name, Stage and Amount, and show the rows as a table.

Tools used: zoho__query

What comes back: A table of deals from your own organization, up to 2,000 rows per call. The field names in the select clause have to exist in your module.

3. Update records in a batch

Set the Lead_Status of the leads I just listed to Contacted, then check the result for each record and report any that failed.

Tools used: zoho__write

What comes back: Updated records in Zoho CRM, up to 100 per call. Because a 200 response can still hold per-record errors, the prompt asks Cursor to check each one.

Each answer comes from your own Zoho CRM data, so this page describes what comes back instead of showing sample numbers. Replace module and field names with ones from your organization.

Ryze AI vs Zoho MCP

Zoho also sells its own MCP product, Zoho MCP, which covers many Zoho apps. The two suit different setups.

Option	Setup	Zoho coverage	Access
Ryze AI connector	Connect Zoho CRM in Ryze AI with the Zoho sign-in, then add one URL to Cursor (Add to Cursor link or mcp.json). OAuth with PKCE for the Ryze AI sign-in	4 tools on Zoho CRM only: read, query (COQL), write and delete	The Zoho scopes you approve; several CRM organizations per workspace
Zoho MCP (Zoho)	Created in Zoho MCP, which Zoho describes as an MCP product for exposing Zoho app tools to AI agents. Zoho's page does not name Cursor as a client; it names Claude and GPT. Check Zoho's setup articles for the server URL	CRM, Mail, Calendar, Desk, Cliq, Projects and WorkDrive, plus third-party integrations, according to Zoho	OAuth; agents run with user-level permissions, according to Zoho

Zoho MCP spans more Zoho apps than the Ryze AI connector, which covers Zoho CRM only. The Ryze AI connector fits when you already use it in Cursor for other platforms and want CRM on the same URL. If you need Mail, Desk or Projects in the same server, look at Zoho MCP first. Zoho publishes no Cursor setup on the page we checked, so confirm the steps in Zoho's own documentation.

Sources: Zoho MCP, Cursor MCP documentation, Ryze AI Zoho CRM guide. Checked November 13, 2026.

Zoho CRM API limits

Zoho CRM's own API credit limits apply to every call the tools make. Zoho's documentation lists a daily base of 50,000 credits on paid editions plus a per-user amount that varies by edition, 5,000 credits on the Free edition, and 5 to 25 simultaneous active calls depending on edition. Standard calls cost 1 credit, and an insert, update or upsert costs 1 credit per 10 records. Large batch jobs can use up credits, so check your edition on Zoho's API limits page.

Source: Zoho CRM API limits. Checked November 13, 2026.

Cursor and Zoho CRM errors and fixes

The Zoho CRM tools do not appear in Cursor: If Zoho CRM was connected in Ryze AI after the server was added, remove the ryze entry and add it again, then start a new chat so the tool list refreshes.
Cursor never asks me to sign in: Go to Customize in the sidebar, locate ryze and reconnect it. The sign-in needs no client ID, since Cursor registers itself from the connector's metadata.
A list call is rejected: Zoho rejects list calls without field names. Ask Cursor to name the fields to return, for example by listing the module's fields first.
A query stops at 2,000 rows: A COQL query returns up to 2,000 rows per call, and page-based pagination stops past 2,000 records. Narrow the where clause, for example by date, and run it in slices.
A write says success but a record did not change: A 200 response can still hold per-record errors. Ask Cursor to read back each record in the response and report the ones that carry an error.
Cursor updates the wrong organization: The primary connection is used unless you name another. Name the organization in the prompt or pass its connection_id, and check which one is primary under View on the Zoho CRM card.
A Cloud Agent cannot reach Zoho CRM: Cloud Agents hold their own sign-ins. Add the Ryze AI server for the agent, separate from the desktop setup.
The server is blocked on a team account: On Enterprise, admins set the allowed servers and tools. Ask yours to permit the Ryze AI server in Team Settings > MCP Configuration.
The tools reply that a subscription is required: The Zoho CRM tools need an active Ryze AI plan or free trial. Start the trial, then retry.

Frequently asked questions

How do I connect Cursor to Zoho CRM?

Connect Zoho CRM in Ryze AI under Integrations by signing in to Zoho and approving access, then add https://connector.get-ryze.ai/mcp to Cursor with the Add to Cursor link or a url entry in mcp.json. Sign in when Cursor asks.

Is there a Zoho CRM MCP server for Cursor?

The Ryze AI connector at https://connector.get-ryze.ai/mcp exposes 4 Zoho CRM tools and installs in Cursor by link or mcp.json. Zoho also offers its own product, Zoho MCP, covering CRM, Mail, Desk and other Zoho apps; its page names Claude and GPT as compatible and does not mention Cursor.

Which should I use, Ryze AI or Zoho MCP?

Ryze AI is the best way to bring Zoho CRM into Cursor next to other platforms on one connector URL, but it covers Zoho CRM only. Zoho MCP spans more Zoho apps, so it fits better if you need Mail, Desk or Projects in the same server.

Do I need a Zoho API key?

No. You sign in to Zoho from the Zoho CRM card in Ryze AI and approve access to CRM modules, settings, users and organization details. Any Zoho data center works, and access renews automatically.

Can Cursor change my Zoho CRM records?

Yes. Through Ryze AI it can create, update and upsert records, up to 100 per call, and delete records when you ask. Deleted records go to the Zoho CRM recycle bin. Ryze AI documents record changes only, not changes to settings or modules.

Which Cursor plan do I need?

Cursor's MCP documentation names none. Enterprise admins can restrict which MCP servers users run, in Team Settings > MCP Configuration.

Does Cursor ask before changing a record?

Yes, unless you change it. Cursor prompts before any MCP tool call under its Run Modes, and tools you allowlist skip the prompt.

Can I connect more than one Zoho CRM organization?

Yes. Click View on the Zoho CRM card and choose Add one more account. One organization is the primary and is used unless you name another, and the tools accept an optional connection_id.

How many rows can a COQL query return?

The query tool returns up to 2,000 rows per call. Past 2,000 records, page-based pagination stops and a page token is needed, so narrow the where clause and run slices.

Can I use a Ryze AI API key instead of the browser sign-in?

Yes. Put your rk_live_ key (Workspace Settings > Profile > API keys) in an Authorization Bearer header in mcp.json, read from an environment variable like RYZE_API_KEY.

How much does it cost to connect Cursor to Zoho CRM?

Adding the connector costs nothing, but the Zoho CRM tools need an active Ryze AI plan or free trial. Paid Ads is $89 per month with a 7-day free trial, SEO Starter is $129 per month with a 3-day free trial, and Agency is $279 per month. Annual billing takes 30% off the first year.

How do I disconnect Zoho CRM from Cursor?

Toggle the ryze server off from Customize in Cursor or remove its entry from mcp.json. To remove CRM access itself, disconnect Zoho CRM on its card in Ryze AI.