By Ira Bodnar, Ryze AI · Updated · Connector tested November 13, 2026
Quick answer
The main way to connect Gemini to Zoho CRM is the Ryze AI connector. Sign in to Zoho from the Zoho CRM card in a Ryze AI workspace, then paste https://connector.get-ryze.ai/mcp into the Gemini web app as a custom app (Settings, then Connected Apps) and call it with @ in a prompt. Google opens custom apps to adults in the US who use a personal Google Account. In Gemini CLI, a single gemini mcp add command points to the same address.
- In Ryze AI open Integrations, filter by CRM and click Connect on Zoho CRM
- Sign in to Zoho on your data center and approve access to modules, settings, users and organization details
- In the Gemini web app go to Settings, Connected Apps and add a custom app with the connector URL
- Finish the Ryze AI sign-in with Allow connection, then type @ in a prompt and choose Ryze AI
Gemini to Zoho CRM at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector. The Gemini web app adds it as a custom app by URL, and Gemini CLI adds it with gemini mcp add |
| Connector URL | https://connector.get-ryze.ai/mcp |
| Sign-in on the Zoho side | Zoho OAuth inside Ryze AI, on any Zoho data center, with access that renews by itself. One connection holds one Zoho CRM organization |
| Sign-in on the Gemini side | A Ryze AI page that ends with Allow connection. Ryze AI supports dynamic client registration, so the web app asks for no client ID or secret. Gemini CLI can send a Ryze AI API key in a header instead |
| Zoho CRM tools | 4: zoho__read and zoho__query read, zoho__write creates, updates and upserts, zoho__delete moves records to the recycle bin |
| Can Gemini change records | Yes, through zoho__write and zoho__delete. The web app wants your confirmation for every write action, and Gemini CLI asks before each tool call unless the server is trusted |
| Who can use it in Gemini | Web app: 18 or over, in the US, a personal Google Account with Keep Activity on, English, no plan named. Gemini CLI: Gemini Code Assist Standard or Enterprise licenses and paid API keys. Google AI Pro and Ultra subscribers lost it on June 18, 2026 |
| Zoho API use | Each Zoho CRM API request the tools send counts against your organization's rolling 24-hour credit allowance. A COQL query costs 1 to 3 credits, by the number of rows asked for |
| Ryze AI price | Paid Ads at $89 per month, starting with a 7-day free trial. Adding the connector is free |
| Zoho CRM in Gemini without Ryze AI | Google's Connected Apps table lists a Zoho CRM app for personal accounts in India only. Zoho's own MCP routes do not name Gemini on their Zoho CRM pages |
| Last tested | The connector address and its sign-in details on November 13, 2026. No Zoho CRM call and no Gemini step was run |
Before you start
- A Google Account that Gemini allows custom apps on. Per Google's help page you must be 18 or older and in the US, use a personal Google Account (work and school accounts are excluded for now) and keep Keep Activity switched on. The feature is English only. You add the app in the Gemini web app, and from then on it also works in the Gemini mobile app. Google names no subscription for it.
- A Zoho login that can approve CRM access. Ryze AI asks Zoho for access to CRM modules, settings, users and organization details, and any Zoho data center works. The login's own CRM role still limits what Gemini can read or change. If Zoho blocks the approval, ask your Zoho CRM administrator.
- An active Ryze AI plan or free trial. Paid Ads costs $89 per month and starts with a 7-day free trial. Adding the connector is free; the Zoho CRM tools answer only on an active plan or trial. This guide leaves out Gemini Enterprise, where an administrator adds the server with a pre-registered OAuth client ID and secret, which no Ryze AI documentation provides.
How to connect Gemini to Zoho CRM in the Gemini web app
Steps 1 to 3 link your Zoho CRM organization to Ryze AI, and steps 4 to 6 bring Ryze AI into Gemini. Every user pastes the same connector URL.
Connect Zoho CRM in Ryze AI
Sign in to Ryze AI or create an account, open Integrations and use the CRM filter. Click Connect on the Zoho CRM card.
Sign in to Zoho on your data center
Use the Zoho login that belongs to the CRM organization Gemini should work in. Ryze AI accepts any Zoho data center, the US, EU, India and Australia among them.
Approve access to the CRM
Approve the request for CRM modules, settings, users and organization details. The Zoho CRM card then reads Connected, and View shows which organization is linked.
Add the custom app in Gemini
Open gemini.google.com on a computer and click Settings at the bottom, then Connected Apps. If Connected Apps is not there, go through Personal Intelligence first. In the Custom apps area, use the field labelled Add a custom app link to get started, or the Add a custom app button if you already have one. Paste https://connector.get-ryze.ai/mcp and click Next. Leave Advanced features closed: Ryze AI supports dynamic client registration, so no credentials are needed.
Sign in and allow the workspace
Gemini then hands over to on-screen steps. Sign in on the Ryze AI page, pick the workspace where Zoho CRM is connected and click Allow connection.
Pick Ryze AI in a prompt and ask your first question
Type @ in a Gemini prompt and choose the Ryze AI app, then ask: Run a COQL query on Zoho CRM leads created this month and count them by lead source. After the web setup the same app is available in the Gemini mobile app.
The Ryze AI help article for Zoho CRM covers the Zoho CRM side of the connection, and the Zoho MCP page describes Zoho's separate MCP product. Ryze AI has no help page of its own for Gemini.
Source for steps 4 to 6: Gemini custom apps help. Checked November 14, 2026.
Gemini CLI
Gemini CLI, Google's terminal agent, can register the connector as an HTTP server. Check your access first. On June 18, 2026 Google stopped serving Gemini CLI to Google AI Pro and Ultra subscribers and to people on the free Gemini Code Assist for individuals, and sent them to Antigravity CLI. Gemini Code Assist Standard and Enterprise licenses keep working, and so do paid Gemini and Gemini Enterprise Agent Platform API keys. With access in place, this line adds the server for every project:
gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcpWithout -s user the server lands in the project scope, which is the default. When Gemini CLI next starts, the connector answers 401; the CLI then finds the OAuth details, registers itself and opens your browser for the Ryze AI sign-in. Run /mcp auth ryze to start that sign-in by hand or to redo it.
The same entry, written by hand in ~/.gemini/settings.json:
{
"mcpServers": {
"ryze": {
"httpUrl": "https://connector.get-ryze.ai/mcp"
}
}
}The sign-in returns to a localhost address in your browser, so it breaks where there is no browser: headless servers, SSH sessions without X11 forwarding and containers. There, send a Ryze AI API key as a Bearer token in an Authorization header, as in the command below. Gemini CLI asks before every tool call unless the server is trusted; trust: true or --trust removes all of those questions, so keep it off while zoho__delete is loaded. To drop that tool, list it in excludeTools in settings.json or pass --exclude-tools; includeTools works the other way round, as an allowlist, and excludeTools wins when a tool is in both.
gemini mcp add --transport http -s user --header "Authorization: Bearer rk_live_..." ryze https://connector.get-ryze.ai/mcpGemini and MCP: the web app and the CLI side by side
| Topic | Gemini web app | Gemini CLI |
|---|---|---|
| Where the server is added | Settings, Connected Apps, Custom apps. Google's help page links that settings page directly at gemini.google.com/apps. A phone browser on gemini.google.com works too; the mobile app itself has no add step | The gemini mcp add command, or an mcpServers block in ~/.gemini/settings.json for the user or .gemini/settings.json for a project |
| Kinds of server | Remote only: a server reached by its URL. No local command can be entered | Three: httpUrl for Streamable HTTP, url for SSE and command for a local stdio program. httpUrl takes priority when more than one is set |
| How sign-in works | If the server offers dynamic client registration, you enter only the URL. Other servers need credentials under Advanced features, Show more | OAuth 2.0 set off by a 401 answer and finished in a browser window. Tokens live in ~/.gemini/mcp-oauth-tokens.json and are refreshed when a refresh token was issued |
| API keys and headers | Google's help page shows no field for a header, an API key or a bearer token | A headers object on the entry, or -H and --header when the server is added |
| Confirmations | Google says every write action needs a manual confirmation and warns that Gemini can still make mistakes. Reads are not addressed | A question before each call with four answers: Proceed once, Always allow this tool, Always allow this server and Cancel. trust: true skips them all |
| Eligibility | Age 18 or over, the US, a personal Google Account, Keep Activity on, English | Gemini Code Assist Standard or Enterprise licenses and paid API keys. Google AI Pro, Ultra and free Code Assist for individuals no longer qualify since June 18, 2026 |
| Plan | None named for custom apps. Tasks, which can call a custom app in some Gemini Apps, need Google AI Pro or Ultra | Google's pages do not settle whether a free Gemini API key still works |
| Managing the server | Under Custom apps: switch it off, or open More details for Disconnect or Remove app | /mcp, /mcp list, /mcp enable and /mcp disable in a session; gemini mcp list, remove, enable and disable in the shell; /mcp reload fetches the tools again |
| Limits | Google states no cap on custom apps or on their tools | No cap on servers or tools is stated. A request times out after 600,000 ms, or 10 minutes, unless the entry sets timeout |
Sources: Gemini custom apps help, Gemini tasks help, Gemini CLI MCP servers, Gemini CLI transition to Antigravity CLI. Checked November 14, 2026.
Other AI clients
Other MCP clients take the same address. Because Zoho CRM is linked once inside Ryze AI, the Zoho side stays as it is.
Claude
In Claude, add the same URL as a custom connector under Customize, then Connectors. The Claude guide under Related guides has every step.
ChatGPT
OpenAI's help center limits full custom MCP support to ChatGPT Business and Enterprise/Edu, and Pro accounts get read and fetch permissions only. Add Ryze AI as a custom MCP server, choose OAuth and paste the same URL.
Cursor
Put the entry below in .cursor/mcp.json. Cursor signs in with OAuth and dynamic client registration: log in on the Ryze AI page and click Allow connection.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Zoho CRM permissions and scopes
Zoho sees a normal OAuth sign-in made through Ryze AI. Three choices shape what Gemini can reach in the CRM.
- Which Zoho login
- Gemini acts as the Zoho login you connect in Ryze AI, so that login's CRM role sets the limits. Pick a login whose reach you are comfortable exposing in a chat.
- Which organization
- Zoho issues tokens for one organization at a time, so each connection is one Zoho CRM organization. Add more to the same workspace with View, then Add one more account. The primary one is used unless you name another, and every tool accepts an optional connection_id.
- Which Gemini account
- The Ryze AI sign-in belongs to the Google Account that added the custom app. Custom apps take personal accounts only, so each teammate adds the app under their own account.
The five Zoho scopes of the Ryze AI connection
Ryze AI requests these five Zoho OAuth scopes, and the access renews by itself. Zoho writes a scope as service, scope name and operation type, and the operation is ALL, CREATE, READ, UPDATE or DELETE. The consent screen stays the final word on the list.
| OAuth scope | What Zoho says it covers | Use through Ryze AI |
|---|---|---|
| ZohoCRM.modules.ALL | Reading, creating, updating and deleting records in every module: leads, accounts, contacts, deals, campaigns, tasks, cases, events, calls, products, quotes, invoices, custom modules and the rest | Record reads, COQL selects, writes and deletes |
| ZohoCRM.settings.ALL | All settings scopes, such as fields, layouts, modules, custom views, tags, territories, roles and profiles. Field metadata and the module list are read under it | Reading module settings and field lists. The write tool is documented for records, so this guide claims no settings changes |
| ZohoCRM.users.READ | Reading user data, with no changes | Listing users, for example to turn owner IDs into names |
| ZohoCRM.org.READ | Reading organization data, with no changes | Reading the organization's details |
| ZohoCRM.coql.READ | Running COQL queries. Zoho pairs it with a modules scope, and with a fields settings scope for field metadata | zoho__query |
Missing from the request when it is set against Zoho's scope list: ZohoCRM.bulk for the Bulk Read and Bulk Write APIs, ZohoCRM.notifications, and write access to users and to the organization, where the request asks for READ only. The consent screen itself was not seen for this guide.
Scopes are a ceiling. Zoho still applies the connected user's own permissions: a module that user cannot read returns 403 NO_PERMISSION, Notes records are open to admin users only, and sensitive health fields come back as null when the organization restricts them for the API. Zoho's COQL page also lists the profile permission Zoho CRM API Access as required.
Sources: Zoho CRM API scopes, Get Records, COQL query API, Access and refresh tokens. Checked November 14, 2026.
Removing access
On the Gemini side, open Settings, Connected Apps and find Ryze AI under Custom apps. Its switch turns it off and leaves it in the list. More details, then Disconnect unlinks the server from your Google Account and revokes its permissions, and More details, then Remove app does the same and deletes the entry. The Linked apps page of your Google Account can unlink it as well. In Gemini CLI, gemini mcp remove ryze takes the server out. On the Zoho side, Zoho says a user can revoke a client's delegated access at any time. The Ryze AI notes for Zoho CRM do not describe a disconnect step on the Zoho CRM card.
What Gemini can do in Zoho CRM
The Ryze AI connector exposes four Zoho CRM tools. Each runs as the Zoho login you connected and takes an optional connection_id to pick one of several organizations. The names come from the Ryze AI app source; no test workspace has Zoho CRM connected, so the list has not been seen live.
| 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, a SQL-like select over CRM modules, returning 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. |
In the Gemini web app, Google's help page says any write action needs your manual confirmation and adds that Gemini can make mistakes. Gemini CLI asks before each tool call until you trust the server or allow a tool for good. The Ryze AI chat keeps a separate Tool approvals control: it begins on Skip all approvals, and Approve write & delete or Manual approve are the stricter choices if you work in that chat. Scheduled tasks run with no approval step at all.
Zoho CRM limits in numbers
These limits belong to your Zoho organization and apply whichever client sends the calls. The figures come from Zoho's API v8 pages, the version Zoho's own MCP overview links to, and the recycle bin row from Zoho's help center. The Ryze AI notes do not say which API version the tools call.
| Limit | Figures | Source |
|---|---|---|
| Daily API credits | A rolling 24-hour window per organization. Free 5,000. Standard and Starter 50,000 plus 250 per user license, up to 100,000. Professional 50,000 plus 500 per license, up to 3,000,000. Enterprise and Zoho One 50,000 plus 1,000 per license, up to 5,000,000. Ultimate and CRM Plus 50,000 plus 2,000 per license, with no cap. Add-on credits come on top | API limits |
| Credits per request | 1 for most calls. COQL: 1 for up to 200 rows, 2 for up to 1,000 and 3 for up to 2,000. Insert, update or upsert: 1 per 10 records. Delete by IDs: 1 per 100 records. Convert Lead 5, a record count of a module 50 | API limits |
| Calls at the same moment | Per organization and app: Free 5, Standard and Starter 10, Professional 15, Enterprise and Zoho One 20, Ultimate and CRM Plus 25. Heavy calls, COQL among them, have a sub-concurrency limit of 10 in every edition. There is no per-minute limit | API limits |
| Running out | HTTP 429 when the credits are used up or too many calls run at once. From 50% used, responses carry the header X-API-CREDITS-REMAINING. A super admin can raise the limit, and the extra credits are billed monthly by use | Status codes, API limits |
| Listing records | 200 records per page at most. The fields parameter is required and takes up to 50 field API names. Rich text is cut to 500 characters, and subforms come back only when one record is read | Get Records |
| Going past 2,000 records | The page parameter stops at 2,000. A page token reaches up to 100,000, belongs to one user and expires after 24 hours | Get Records |
| COQL | LIMIT is 200 by default and 2,000 at most, and LIMIT with OFFSET pages through up to 100,000 records for one set of criteria. Up to 500 fields in SELECT and 25 criteria in WHERE. Joins through lookup fields are capped | COQL overview, COQL limitations |
| Writes | 100 records per insert, update or upsert. A batch that partly fails returns HTTP 207 with one result per record, in input order. Insert and upsert run the module's workflows, approvals and blueprints unless the trigger list is sent empty | Insert Records, Upsert Records |
| Deletes | 100 records per call. Workflow rules run on deletion by default, and subforms go with the record. The recycle bin keeps deleted records for 60 days | Delete Records, Recycle bin |
| Search | At most 2,000 records and 10 criteria. A record created a moment ago may not be found yet, and Zoho points to COQL when no delay is acceptable | Search Records |
| Ryze AI tool caps | zoho__query returns up to 2,000 rows per call and zoho__write takes up to 100 records, the same as Zoho's own caps | Ryze AI tool descriptions, as in the tools table above |
Also used: Zoho CRM API limits, COQL overview, Upsert Records, Zoho CRM recycle bin. Checked November 14, 2026.
First 3 prompts to run
The three prompts use only the four tools above, and every answer is drawn from your own Zoho CRM organization. That is why no sample numbers appear here.
1. Count leads by source with COQL
Run a COQL query on Zoho CRM leads created this month and group the count by lead source.
Tools used: zoho__query
What comes back: One row per lead source with its count. COQL handles where clauses and aggregates, and one call returns up to 2,000 rows.
2. Read a module's fields, then list records
List the fields on the Deals module in Zoho CRM, then show the 20 most recent deals with deal name, amount and stage.
Tools used: zoho__read, zoho__query
What comes back: The field names of the module, then the deals with only the fields you asked for. Zoho refuses a list call that does not name its fields, so naming them avoids that error.
3. Upsert a batch of leads with a check
Upsert these 40 leads into Zoho CRM so existing ones are updated and new ones are created. Check each record in the response for errors and list any that failed.
Tools used: zoho__write
What comes back: The created and updated records. A 200 response can still hold errors for single records, and Zoho documents HTTP 207 for a batch that partly fails, which is why the prompt asks for the check. In the Gemini web app you confirm the write by hand.
For the third prompt, paste your own lead list into the chat; zoho__write takes at most 100 records per call. Deletes go through the same confirmation in the Gemini web app, and Zoho keeps deleted records in its recycle bin for 60 days.
10 jobs to hand to Gemini
Ten jobs to give Gemini once Ryze AI is picked with @ in the web app or added in Gemini CLI, each matched to the tool behind it. None was run for this guide, because no Zoho CRM organization was connected. The last column follows Zoho's documentation for the five scopes.
| Job | Ask Gemini | Tool | Works on the default connection |
|---|---|---|---|
| Leads by source | Count the Zoho CRM leads created this month, grouped by Lead Source. | zoho__query | Yes |
| Open pipeline | List open deals with amount, stage, owner and closing date, the soonest closing first. | zoho__query | Yes |
| Deals with account details | In one query, show each open deal next to the industry of its linked account. | zoho__query | Yes, within Zoho's join limits |
| Field names before a query | List the fields of the Leads module with their API names. | zoho__read | Yes |
| One record in full | Read the contact with this record ID and show every field, subforms included. | zoho__read | Yes |
| Owner names | List the CRM users so owner IDs can be matched to names. | zoho__read | Yes |
| Upsert contacts | Upsert these contacts, matching on Email, and list any record that failed. | zoho__write | Yes, once you confirm the write |
| Move a set of deals | Find open deals whose closing date has passed, show me the list, then set their stage to the one I name. | zoho__query, then zoho__write | Yes, once you confirm. Workflows on the module may run |
| Clean up test records | Delete the three test leads I name below. | zoho__delete | Yes, once you confirm. They stay in the recycle bin for 60 days |
| Add a custom field | Add a custom field called Region to the Leads module. | None | No. The write tool is documented for records only |
2 ways to connect Gemini to Zoho CRM
Two ways reach Zoho CRM from Gemini on the pages checked for this guide. The Ryze AI connector is the main way here: it works in the Gemini web app and in Gemini CLI, and it accepts a Zoho account on any data center. The second is a Zoho CRM app in Google's own Connected Apps list, which only the Gemini app offers. Google's and Zoho's pages behind this table were read on November 14, 2026, and neither way was tried in Gemini.
| Way | Gemini surface | Setup | What it reaches in Zoho CRM | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Gemini web app, then the mobile app; Gemini CLI | Web app: Settings, Connected Apps, Add a custom app, paste https://connector.get-ryze.ai/mcp, Next, then the Ryze AI sign-in. Gemini CLI: gemini mcp add --transport http -s user ryze with the same URL. Zoho CRM is signed in once inside Ryze AI | Records in every module: single reads, module settings, fields and users, COQL selects of up to 2,000 rows, creates, updates and upserts of up to 100 records, and deletes to the recycle bin. Several organizations per workspace. On the Zoho side, Zoho CRM only | A Ryze AI plan or trial, such as Paid Ads at $89 per month after a 7-day free trial. The connector itself is free, and calls use your Zoho API credits |
| Zoho CRM app in Gemini's Connected Apps | Gemini web app, mobile app and Windows app, in chats and tasks | Listed in Google's Connected Apps availability table. Built-in apps are opened from the sidebar under Customize, then Connectors, and switched on with Add. The row allows personal Google Accounts, age 18 or over, in India, in English | Google's description: search, create, update and convert leads, follow revenue deals across pipeline stages, and inspect custom module fields and layouts | Not checked. The app's own page was not opened for this guide |
Zoho CRM options that do not fit Gemini
- Zoho CRM's four pre-built MCP servers. Data Insights, Data Operations, Module Customization and Workflow & Process Automation are installed from Setup, Developer Hub, MCP for AI Agents. Zoho hosts them, so there is nothing to build or run yourself. Zoho has setup pages for Cursor, Claude Desktop, VS Code and Windsurf and says the servers work with any AI tool that supports MCP, yet no Zoho CRM page names Gemini. For the server addresses, use the install button in Zoho CRM or Zoho's setup pages; this guide does not copy them. Calls use API credits like any other request.
- The Zoho MCP console. Here you build your own server from Zoho CRM tools (Zoho's Tool Manual counts 1,319 of them) and third-party ones. Zoho's implementation guide gives steps for Claude, ChatGPT, Cursor, Windsurf and VS Code plus a generic section for other clients. Among the Zoho pages read, Gemini appears only on a help page for Bigin, a different Zoho product, which covers Gemini CLI. The service is $0 and runs on your existing Zoho API quota, and Zoho says to treat the generated URL like a password because it holds an API key.
- The Zoho CRM listing in Claude's connector directory. Made by Zoho, labelled Anthropic verified, with 41 tools and one connector URL per region. It is a listing in Claude's own directory and speaks about Claude only.
- Composio. Its Zoho toolkit shows 113 tools and names Claude, ChatGPT and Cursor, and its framework pages add Claude Code, Codex and several agent SDKs. Gemini is not on those lists. Composio's pricing page caps the free plan at 10,000 tool calls a month and puts Standard at $18 per seat per month.
- Zapier MCP. Each successful call uses 2 tasks from your Zapier plan. The quickstart names Claude, Claude Code, ChatGPT, Cursor and Codex, and its further clients include Gemini Enterprise, Grok, VS Code, Windsurf and Zed. This guide does not cover Gemini Enterprise.
- Windsor.ai. Its Zoho CRM pages give setup steps for ChatGPT and Claude and describe pulling data for analysis, with no word on changing records.
- CData's open-source Zoho CRM server. A local, read-only Java process with 3 tools that needs CData's separately licensed JDBC driver. Its README gives the setup for Claude Desktop. MIT license, 3 GitHub stars, last push October 18, 2025.
Which one to pick
Ryze AI is the best way to connect Gemini to Zoho CRM when you want COQL reports, batch upserts and several CRM organizations behind one address in the Gemini web app or Gemini CLI, with two caveats: on the Zoho side it covers Zoho CRM only, and Google limits its web app route to adults in the US on personal Google Accounts, in English. The same address also serves the other platforms you connect in Ryze AI. Google lists the built-in Zoho CRM app for India only, so the two web routes serve different readers: in India a personal account can switch that app on without a Ryze AI account, and Google's description of it includes lead conversion, which the Ryze AI write tool does not list. For changes to fields, layouts or workflow rules, or for other Zoho apps, Zoho's pre-built servers and the Zoho MCP console cover more ground, but their Zoho CRM pages do not name Gemini, so expect to test them yourself.
Sources: Google Connected Apps availability, Gemini Connected Apps help, Zoho CRM MCP overview, Zoho MCP implementation guide, Zoho MCP for Bigin, Zoho MCP pricing, Zoho MCP Tool Manual, Zoho CRM in Claude's directory, Composio Zoho toolkit, Composio pricing, Zapier MCP quickstart, Zapier MCP usage, Windsor.ai Zoho CRM to ChatGPT, CData Zoho CRM MCP server. Checked November 14, 2026.
Gemini, Zoho CRM and MCP: dates that matter
| Date | What happened |
|---|---|
| June 25, 2025 | Google announced Gemini CLI, with MCP support built in. |
| July 17, 2025 | Zoho announced its own MCP server in a press release, with more than 15 Zoho tools in early access. |
| March 9, 2026 | Zoho published the launch post for Zoho MCP, its service for building MCP servers. |
| April 6, 2026 | Zoho announced built-in MCP support in Zoho CRM, the pre-built servers, rolling out in phases. The documentation read on November 14, 2026 does not say whether every data center has it. |
| May 19, 2026 | Google announced the move from Gemini CLI to Antigravity CLI. |
| June 18, 2026 | Gemini CLI stopped serving Google AI Pro and Ultra subscribers and free Gemini Code Assist for individuals. |
| June 30, 2026 | Google wrote that support for custom MCP was rolling out in Gemini Spark, the feature now called tasks. It is the earliest dated Google mention of custom apps found for this guide. |
| October 2026 | The Zoho MCP changelog shows its latest Zoho CRM release: 95 tools added and 85 removed, for the US, EU, IN, AU, JP, CA and SA data centers. |
| October 13, 2026 | Customize arrived in the Gemini left menu as the single place for connected apps and skills, with more than 40 apps or services. |
| November 10, 2026 | Gemini CLI v0.68.0 was published. It was still the latest stable release on November 14, 2026. |
| November 14, 2026 | Google's Connected Apps table listed a Zoho CRM app for India, the Zoho MCP pricing page said $0, and Zoho's documentation listed four pre-built Zoho CRM servers. |
Sources: Gemini CLI launch post, Zoho press release, July 17, 2025, Zoho MCP launch post, Zoho CRM built-in MCP announcement, Gemini CLI transition to Antigravity CLI, Gemini Spark update, June 2026, Zoho MCP changelog, Gemini release notes, Gemini CLI v0.68.0, Google Connected Apps availability. Checked November 14, 2026.
How this guide was tested
One check stands behind this guide: the connector's address and its sign-in details, on November 13, 2026. Everything about Zoho CRM and Gemini follows the vendors' pages as they read on November 14, 2026.
| Check | Result |
|---|---|
| The connector address with no sign-in (November 13, 2026) | https://connector.get-ryze.ai/mcp answered HTTP 401 with a WWW-Authenticate header pointing to the sign-in details. Gemini CLI's documentation names a 401 answer as the signal that starts its OAuth discovery. |
| The two discovery files (November 13, 2026) | Both loaded from the connector's host. They list the authorize, token and register endpoints, the authorization code and refresh token grants, PKCE with S256, and the scopes mcp:read and mcp:write. |
| The Zoho CRM tool list | Not seen live. The four names in the tools table come from the Ryze AI facts, which took them from the app source, because no test workspace has Zoho CRM connected. |
| Calls to Zoho CRM | None. No Zoho CRM test account was connected, so no Zoho CRM call was run and no Zoho message was recorded. |
Nothing was done inside Gemini for this page. Nobody pasted the connector address into Connected Apps, registered it in Gemini CLI or asked Gemini a Zoho CRM question, so Ryze AI has not been tested in Gemini. The Gemini steps follow Google's custom apps help page and the Gemini CLI documentation as of November 14, 2026. The Zoho CRM app in Gemini's Connected Apps, Zoho's pre-built servers and the Zoho MCP console were not tried either.
Zoho CRM errors and fixes
No Zoho CRM call was run for this guide, so this section holds no messages copied from a test. Where an entry names an error code, it is the code Zoho's API documentation gives for that case.
- Gemini shows no Connected Apps or no Add a custom app
- Check Google's conditions: a personal Google Account, age 18 or over, the US, Keep Activity on and English. Adding works only on the web at gemini.google.com. If Connected Apps is not listed under Settings, open Personal Intelligence first.
- Gemini asks for a client ID or secret
- Leave Advanced features closed. Ryze AI supports dynamic client registration, the case in which Google's help page needs only the URL.
- Zoho sign-in fails or opens the wrong region
- Use the data center where your Zoho account was registered: Zoho keeps each account's data in one data center, and Ryze AI accepts any of them. When Zoho refuses the approval itself, your Zoho CRM administrator is the person to ask.
- The wrong Zoho CRM organization answers
- Click View on the Zoho CRM card in Ryze AI and add the right organization with Add one more account. Then name it in the chat or pass its connection_id; otherwise the primary one is used.
- A list request fails with REQUIRED_PARAM_MISSING or LIMIT_EXCEEDED
- Zoho rejects a list call that names no fields (REQUIRED_PARAM_MISSING) or more than 50 of them (LIMIT_EXCEEDED). Ask Gemini to read the module's fields first and to request at most 50 by API name.
- Results stop at 2,000 records
- Past 2,000 records the page parameter stops working, and Zoho documents DISCRETE_PAGINATION_LIMIT_EXCEEDED for it; a page token is needed beyond that point. Narrow the query with a where clause or ask for smaller slices.
- A write says success but a record is missing
- A response that looks successful can still carry errors for single records, and Zoho documents HTTP 207 for a batch that partly fails. Ask Gemini to check the result for each record.
- Zoho CRM tools do not appear in Gemini
- If the custom app was added before Zoho CRM was connected in Ryze AI, remove the app, add it again and open a new chat so the tool list is read again.
- Gemini CLI sign-in fails on a remote machine
- The OAuth step needs a local browser and a localhost callback. Send a Ryze AI API key in an Authorization header instead, or sign in on a machine with a browser.
- Gemini CLI says you no longer have access
- Since June 18, 2026 Gemini CLI does not serve Google AI Pro and Ultra subscribers or free Gemini Code Assist for individuals. Google points those users to Antigravity CLI.
- 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.
Sources: Get Records, Insert Records, Multi DC, Gemini CLI MCP servers. Checked November 14, 2026.
Terms on this page
- Custom app
- Google's name for an MCP server that you link to the Gemini app by its URL. The Ryze AI connector joins Gemini as one.
- COQL
- CRM Object Query Language, Zoho CRM's SQL-like SELECT language. It works with module and field API names and can join modules through lookup fields.
- API name
- The name Zoho uses for a module or a field in API calls and COQL. Zoho lists them under Setup, Developer Hub, APIs and SDKs, API Names.
- API credit
- The unit Zoho CRM counts API use in. Most calls cost 1, and each edition gets an allowance per rolling 24 hours.
- Upsert
- A write that updates the record matching a duplicate check field, such as Email for leads and contacts, or creates a new record when nothing matches.
- Data center
- The Zoho region an account belongs to, each with its own sign-in and API domain. Zoho's token page lists the US, Australia, the EU, India, China, Japan, Saudi Arabia and Canada.
- Recycle bin
- Where Zoho CRM puts deleted records. They can be restored for 60 days, after which Zoho deletes them for good.
Sources: Gemini custom apps help, COQL overview, Zoho CRM API limits, Upsert Records, Access and refresh tokens, Zoho CRM recycle bin. Checked November 14, 2026.
Frequently asked questions
How do I connect Gemini to Zoho CRM?
Connect Zoho CRM in a Ryze AI workspace first: open Integrations, click Connect on the Zoho CRM card, sign in to Zoho and approve access. Then on gemini.google.com go to Settings, Connected Apps, Add a custom app, enter https://connector.get-ryze.ai/mcp, click Next, sign in on the Ryze AI page and click Allow connection. In a prompt, type @ and choose Ryze AI.
Does Zoho CRM have a Gemini connector?
Google's Connected Apps table lists a Zoho CRM app for Gemini, open to personal Google Accounts aged 18 or over in India, in English. Zoho's own MCP routes for Zoho CRM, the pre-built servers and the Zoho MCP console, do not name Gemini on their Zoho CRM pages. In the US, a custom app such as the Ryze AI connector is the documented route.
Which Zoho CRM connector should I use with Gemini?
Ryze AI is the best way to connect Gemini to Zoho CRM when you want COQL queries, batch writes and several CRM organizations behind one URL, with a caveat: on the Zoho side it covers Zoho CRM only. For other Zoho apps or for changes to fields and workflow rules, look at Zoho MCP or Zoho CRM's pre-built servers, and confirm they work with Gemini first, because their Zoho CRM pages do not name it.
Which Gemini plan do I need?
Google's help page for custom apps names no plan. It asks for age 18 or over, a US location, a personal Google Account and Keep Activity on, and the feature is English only. Tasks that call a custom app need Google AI Pro or Ultra.
Can I use Zoho CRM in Gemini outside the US?
Not through custom apps for now, because Google limits them to the US. In India, Google's Connected Apps table lists a built-in Zoho CRM app for personal accounts. Gemini CLI reaches the Ryze AI connector without the custom apps conditions, but Google limits it to Gemini Code Assist Standard or Enterprise licenses and paid API keys.
What Zoho permissions do I need?
A Zoho login that can approve five OAuth scopes: ZohoCRM.modules.ALL, ZohoCRM.settings.ALL, ZohoCRM.users.READ, ZohoCRM.org.READ and ZohoCRM.coql.READ. Any Zoho data center works. Gemini sees only what that login's CRM role allows, and a Zoho CRM administrator can help when Zoho blocks the approval.
Can Gemini edit or delete Zoho CRM records?
Yes, through the Ryze AI write and delete tools. zoho__write creates, updates or upserts up to 100 records per call, and zoho__delete removes records singly or in bulk into the Zoho CRM recycle bin, where they can be restored for 60 days. Google says the Gemini app requires a manual confirmation for any write action.
Can Gemini change Zoho CRM fields, layouts or workflow rules?
Not through Ryze AI as documented, because its write tool covers records only. Zoho CRM's Module Customization and Workflow & Process Automation servers handle that work, but Zoho's setup pages for them name Cursor, Claude Desktop, VS Code and Windsurf and leave Gemini out.
Can I run COQL queries from Gemini?
Yes. zoho__query runs COQL, Zoho CRM's SQL-like select over modules, and returns up to 2,000 rows per call. Where clauses, aggregates and joins through lookup fields are supported. Each query costs 1 to 3 Zoho API credits, depending on its row limit.
How many Zoho API credits does Gemini use?
Each Zoho CRM API request the tools send uses credits from your organization's rolling 24-hour allowance. Most requests cost 1 credit, a COQL query 1 to 3 depending on rows, and a write 1 credit per 10 records. The Free edition gets 5,000 credits per window, and paid editions start from a base of 50,000.
Can I use Gemini CLI with Zoho CRM?
Yes, if your account still has Gemini CLI. Run gemini mcp add --transport http -s user ryze https://connector.get-ryze.ai/mcp, start Gemini CLI and finish the Ryze AI sign-in in the browser. Since June 18, 2026 Google AI Pro and Ultra subscribers and free Gemini Code Assist for individuals users no longer get Gemini CLI; Google sends them to Antigravity CLI.
Does this work with Gemini Enterprise?
This guide does not cover it. In Gemini Enterprise an administrator adds custom MCP servers in the Google Cloud console with a pre-registered OAuth client ID and secret, and no Ryze AI documentation provides one.
Can I connect more than one Zoho CRM organization?
Yes. Click View on the Zoho CRM card in Ryze AI and choose Add one more account. The primary organization is used by default; name another in the chat or pass its connection_id.
Why do the Zoho CRM tools not show up in Gemini?
If Zoho CRM was connected in Ryze AI after you added the custom app, remove the app under Settings, Connected Apps, add it again and start a new chat. Keep Activity must also be on, because Google makes custom apps unavailable without it.
How much does it cost to connect Gemini to Zoho CRM?
Adding the connector is free, and 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, and annual billing takes 30% off the first year. Zoho counts the calls against your organization's API credits.
How do I disconnect Zoho CRM from Gemini?
In Gemini, open Settings, Connected Apps and switch the Ryze AI custom app off, or use More details, then Disconnect or Remove app. In Gemini CLI run gemini mcp remove ryze. Zoho also lets a user revoke a client's delegated access at any time.