By Ira Bodnar, Ryze AI · Updated · Connector tested November 15, 2026
Quick answer
The main way to connect Antigravity to Zoho CRM is the Ryze AI connector. Connect Zoho CRM in Ryze AI with a Zoho sign-in, then add a ryze entry with the serverUrl https://connector.get-ryze.ai/mcp to Antigravity's mcp_config.json and finish the Ryze AI sign-in. The agent then has 4 Zoho CRM tools: 2 that read, 1 that writes and 1 that deletes. You create no Zoho client of your own.
- In Ryze AI open Integrations, click Connect on the Zoho CRM card, sign in to Zoho and approve access to CRM modules, settings, users and organization details
- In Antigravity open MCP Servers, Manage MCP Servers, View raw config and add the ryze entry
- Complete the Ryze AI sign-in and click Allow connection, then start a new agent chat
- Ask for a COQL count of leads by lead source and approve the first tool call
Antigravity to Zoho CRM at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, a hosted MCP server that Antigravity reaches through a single serverUrl entry. Zoho is signed in once inside Ryze AI and nothing runs on your machine |
| Server address | https://connector.get-ryze.ai/mcp |
| Where the entry goes | mcp_config.json: ~/.gemini/config/mcp_config.json for every project, or .agents/mcp_config.json for one workspace. The IDE, the App and the CLI read the same format |
| Sign-in | Two separate sign-ins. Zoho uses OAuth inside Ryze AI, and any Zoho data center works. Antigravity then signs in to the connector with OAuth 2.0 and PKCE, with no client ID to type |
| Zoho CRM tools | 4 in all: zoho__read, zoho__query, zoho__write and zoho__delete |
| Can it change things | Yes, records only. zoho__write creates, updates or upserts up to 100 records per call and zoho__delete removes records into the Zoho CRM recycle bin. Fields, modules and layouts are out of reach. Antigravity holds MCP tools without a rule in Ask mode, so each call waits for a click |
| Other data in the same chat | None from Zoho apps outside CRM, because the connection covers Zoho CRM only. Tools for other platforms you connect in the same Ryze AI workspace appear under the same address |
| Antigravity plan needed | None is named. Google's MCP page lists no plan |
| Ryze AI price | Adding the connector costs nothing, and the tools need an active plan or trial: Paid Ads is $89 per month with a 7-day free trial, SEO Starter $129 per month with a 3-day free trial, Agency $279 per month |
| Zoho's own option | Four pre-built Zoho CRM MCP servers inside Zoho CRM, plus the Zoho MCP console for a server you build yourself. Zoho's setup pages name Claude Desktop, Cursor, VS Code and Windsurf, and none names Antigravity |
| Last checked | Zoho pages on November 14, 2026 and Google Antigravity pages on November 15, 2026. No Zoho CRM call was run through the connector and nothing was run inside Antigravity |
Before you start
- Google Antigravity. Google's MCP page names no plan. It covers the standalone IDE, the desktop App and the CLI, and all three read one mcp_config.json format. The standalone IDE is not supported on enterprise accounts, and an admin may have to allow MCP servers first.
- A Zoho CRM user with API access. Zoho's COQL page lists the profile permission Zoho CRM API Access as required. Which profiles hold it by default was not checked. The connection's scopes set the ceiling, and the permissions of the Zoho user who connects still apply: Zoho answers NO_PERMISSION when that user cannot read a module.
- A Ryze AI workspace on a 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. Connecting is free, and the Zoho CRM tools need an active plan or trial. Annual billing takes 30% off the first year.
How to connect Antigravity to Zoho CRM
These steps are for the Antigravity IDE. One happens in Ryze AI, four in the editor. The App and the CLI use the same config entry and are covered below.
Connect Zoho CRM in Ryze AI
Sign in to Ryze AI, open Integrations and find the Zoho CRM card under the CRM filter. Click Connect, sign in to Zoho (US, EU, India, Australia and other data centers all work) and approve access to CRM modules, settings, users and organization details. The card then shows Connected, and View shows the organization name. Do this before you add the connector to Antigravity so the tool list is complete the first time.
Open the raw MCP config in the Antigravity IDE
In the agent side panel of the editor, click the ... menu at the top and choose MCP Servers. Click Manage MCP Servers, then View raw config. This opens mcp_config.json: ~/.gemini/config/mcp_config.json covers every project and .agents/mcp_config.json covers one workspace.
Add the ryze entry
Under mcpServers add an entry named ryze with the serverUrl https://connector.get-ryze.ai/mcp and save. No client ID or secret goes in the file, because the Ryze AI connector offers dynamic client registration and Antigravity registers itself.
Sign in to Ryze AI
Antigravity handles the browser sign-in for the server, and Google's MCP page does not describe how it begins in the IDE. On the Ryze AI page pick the workspace that holds your Zoho CRM connection and click Allow connection. If the entry was added before Zoho CRM was connected, remove it, add it again and open a new chat so the tool list refreshes.
Ask your first question
Open a new agent chat and ask: Run a COQL query on Zoho CRM that counts the leads created this month, grouped by lead source. Antigravity asks for approval before an MCP tool runs until you allow it, so approve the first call.
The Ryze AI help article for Zoho CRM covers the Zoho sign-in and the organization choice. There is no Ryze AI help page for Antigravity, and Ryze AI was not tested in it for this page.
Sources: Google's Antigravity MCP documentation, checked November 15, 2026, and the Ryze AI Zoho CRM guide.
Antigravity App
The Antigravity App keeps its MCP servers on the Customizations page and has an Authenticate button of its own, so the sign-in differs from the IDE. One layout matters: in the Knowledge Work layout the Installed tab lists plugins only and the MCP Servers section is hidden. Choose Software Engineering under Settings > General > Interface Layout first. Business and enterprise accounts always use Software Engineering.
- Click Customizations in the sidebar, then Installed, and scroll down to MCP Servers.
- Click Copy Config File Path and add the ryze entry shown below to that mcp_config.json.
- Go back to Customizations, Installed, MCP Servers and click Authenticate next to ryze.
- Sign in to Ryze AI in the browser, copy the authorization code, paste it into Enter authorization code and click Submit. The server reconnects by itself.
The entry to add is the same in the IDE, the App and the CLI:
{
"mcpServers": {
"ryze": {
"serverUrl": "https://connector.get-ryze.ai/mcp"
}
}
}The App's Add MCP Server (+) button opens a searchable catalog with no address field, so a custom server goes into mcp_config.json by hand. Remote servers must use Streamable HTTP: Google's docs reject the older HTTP+SSE transport and the httpUrl key, and accept url as another name for serverUrl. Antigravity's OAuth redirect URI is https://antigravity.google/oauth-callback.
Antigravity CLI
The Antigravity CLI (agy) reads the same two files. Put the ryze entry in ~/.gemini/config/mcp_config.json or in <workspace>/.agents/mcp_config.json, then type /mcp in the prompt panel to open the MCP Manager, which shows a status line per server and reloads the configuration. Use a different name for a workspace entry than for a global one, because when two files share a name the server already running wins. The CLI replaced Gemini CLI for personal accounts.
Google documents the Authenticate steps for the App only. The CLI changelog mentions a sign-in link for OAuth servers (version 1.5.2, November 6, 2026), but no Google page lists CLI sign-in steps, so none are given here. The changelog also names mcp add, remove, list, enable and disable subcommands without their syntax, so none is shown. OAuth tokens are kept in ~/.gemini/antigravity/mcp_oauth_tokens.json and refreshed automatically.
Sources: Google's Antigravity MCP documentation, the Gemini CLI to Antigravity CLI update, the Gemini CLI migration page, the Antigravity changelog and the connector checks on this page. Checked November 15, 2026.
Antigravity and MCP: the facts in one table
| Topic | What Google's Antigravity pages say |
|---|---|
| Where MCP works | The MCP page covers the Antigravity App, the CLI and the standalone IDE. The Visual Studio extension page describes the same two mcp_config.json files |
| Config format | An mcpServers map keyed by server name, identical on every surface. An enabled plugin can ship servers in its own <plugin-root>/mcp_config.json |
| Local or remote | command starts a local stdio process. serverUrl (or url) points at a remote Streamable HTTP server |
| Extra headers | A headers object on a remote entry sends custom HTTP headers, such as an Authorization bearer token |
| OAuth order | oauth.clientId (and an optional clientSecret) from the file first, then a Client ID Metadata Document, then dynamic client registration. The Ryze AI connector lists a registration endpoint and no metadata document, so the third route applies |
| Approvals | An MCP tool with no rule waits in Ask mode. Rules are written mcp(server/tool), mcp(server/*) or mcp(*), and Deny beats Ask beats Allow |
| Skipping the prompt | Turbo in the App on a personal account runs MCP tools without asking. In the CLI, request-review is the default and always-proceed skips the prompt unless an ask or deny rule matches |
| Trimming a server | enabledTools keeps only the tools you list, disabledTools hides listed ones, and disabled: true pauses a server but keeps its entry |
| Tool loading | Tools load lazily by default and their schemas are cached on disk |
| Timeouts | Up to 5 minutes for a server to connect and list tools and up to 3 minutes per tool call, both set by timeoutSeconds |
| Plan and enterprise | No plan is named for MCP. The standalone IDE is unsupported for enterprise deployments, and admins can set MCP allowlists |
| Bringing servers over | The App can import MCP servers from Claude Code, Codex and Cursor into a plugin you own, per the v2.30.0 changelog entry |
Sources: MCP, permissions, settings, plans, enterprise, getting started, Visual Studio extension and changelog pages of Google Antigravity. Checked November 15, 2026.
Other AI clients
The same URL works in other MCP clients. Zoho CRM is connected once in Ryze AI, so nothing changes on the Zoho CRM side.
Gemini
Google's other assistant takes the same URL with different steps. See How to connect Gemini to Zoho CRM. For the Antigravity client in general, see Ryze AI in Antigravity.
Claude Code, Codex, Cursor and VS Code
Each coding client has its own guide: Claude Code, Codex, Cursor and VS Code.
Claude and ChatGPT
Both add the URL as a custom connector. See How to connect Claude to Zoho CRM and How to connect ChatGPT to Zoho CRM.
Zoho CRM access and permissions
Access comes from the Zoho sign-in, not from Antigravity. Antigravity signs in to the Ryze AI connector, and the scopes approved on the Zoho consent screen decide what the connection can reach. Four points cover it.
- Zoho sign-in through Ryze AI
- You sign in to Zoho from the Ryze AI Integrations page and approve access to modules, settings, users and organization details. Every Zoho data center is accepted and renewal is automatic. Per Zoho, an access token expires after an hour and a refresh token stays valid until the user revokes it.
- Whose rights apply
- Scopes are an upper bound. The Zoho profile of the person who clicked Connect still decides which modules can be read, and Zoho's documented 403 NO_PERMISSION answer covers a module that person cannot see. Zoho also limits the Notes module to admin users. Choose the connecting user with that in mind.
- Ryze AI sign-in from Antigravity
- Antigravity registers itself with the connector through dynamic client registration and stores the OAuth token in its own file. The agent sees the Zoho CRM organization connected in the workspace you pick on the Ryze AI page, and nothing else.
- One organization per connection
- Zoho issues a token for a single organization. A workspace can hold several connections, one is the primary and is used unless you name another, and every tool accepts an optional connection_id.
The Zoho CRM scopes behind the connection
Ryze AI's facts list five scopes for the Zoho connection. A Zoho scope has three parts, service, scope name and operation type, and the operation type is ALL, CREATE, READ, UPDATE or DELETE. The table gives what Zoho says each one covers and which tool it matters for.
| Scope | What Zoho says it covers | Matters for |
|---|---|---|
| ZohoCRM.modules.ALL | Read, create, update and delete records in all modules, such as Leads, Accounts, Contacts, Deals, Campaigns, Tasks, Cases, Calls, Products, Quotes, Invoices and custom modules | zoho__read, zoho__write and zoho__delete on records |
| ZohoCRM.settings.ALL | All settings scopes, including modules, fields, layouts, tags, variables, roles, profiles and currencies. Field metadata and the module list are read with it | Looking up module and field API names. The scope is broader than the tools, which write records only |
| ZohoCRM.users.READ | Get user data. No changes to users | Mapping owner IDs to names |
| ZohoCRM.org.READ | Get organization data. No changes to the organization | Organization details |
| ZohoCRM.coql.READ | Run COQL queries. Zoho asks for it together with a modules scope, and a settings fields scope to read field metadata | zoho__query |
Zoho's consent screen was not opened for this guide, and which OAuth scopes the Ryze AI connector hands an Antigravity sign-in was not tested. The connector's discovery data names mcp:read and mcp:write for that sign-in. The Zoho scopes above belong to the Zoho sign-in, which is the same whichever AI client calls the tools.
Out of reach on the default connection: the Bulk Read and Bulk Write APIs and the notifications scopes (none is in the list), writing to users or to the organization (only the two READ scopes are asked for), and changes to fields, modules, layouts or workflow rules, because the write tool covers records only. Zoho apps other than CRM are also outside the connection.
Sources: Zoho scopes, OAuth overview, token validity, COQL overview, checked November 14, 2026. Ryze AI's connection details from the Ryze AI Zoho CRM guide.
Limits that shape the answers
These limits shape what comes back. The first four come from Ryze AI's connection facts and the last three from Google's Antigravity MCP page.
| Area | Limit |
|---|---|
| Record tools only | The write tool covers records. Do not ask the agent to add a field or edit a module. |
| Field names on list calls | A list call needs the field names to return, and Zoho rejects one without them. Ask for the fields you want, or use a COQL query. |
| Past 2,000 records | Page-based paging stops at 2,000 records and a page token is needed after that. |
| Write responses | A 200 response from a write can still hold errors for single records, so ask the agent to report the result for every record. |
| Timeouts | Antigravity waits up to 5 minutes for a server to connect and list its tools and up to 3 minutes for each tool call. |
| Tool loading | MCP tools load lazily and their schemas are cached on disk, so the agent reads them when needed. |
| Tool approval | An MCP tool without a configured rule runs in Ask mode, and each call needs your approval until a policy allows it. |
Sources: the Ryze AI Zoho CRM guide, the Ryze AI connection facts and Google's Antigravity MCP documentation, checked November 15, 2026.
Removing access
To remove access, delete the ryze entry from mcp_config.json, or set disabled: true to pause it and keep the entry. In the App, More actions (⋮) next to the server offers Disable and Delete. Stored OAuth tokens are in ~/.gemini/antigravity/mcp_oauth_tokens.json. Zoho says users can revoke a client's delegated access at any time. Ryze AI's facts describe no disconnect step for Zoho CRM, so use Zoho's own connected-apps controls or ask Ryze AI support.
What Antigravity can do in Zoho CRM
The Ryze AI connector exposes 4 Zoho CRM tools: 2 read, 1 write and 1 delete. The names come from Ryze AI's facts, which took them from app source. No workspace had Zoho CRM connected, so the tool list was not seen live and was not loaded into Antigravity.
| 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, 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 Antigravity an MCP tool with no rule waits in Ask mode, so each call needs a click. Google's rule forms are mcp(server/tool) and mcp(server/*). Allow zoho__read and zoho__query if you want reads to run freely, and keep zoho__write and zoho__delete in Ask mode. Google's page also lists disabledTools, which hides the tools you name from a server entry, so zoho__delete can be taken away entirely. In the Ryze AI chat the Tool approvals setting starts on Skip all approvals, and Approve write & delete or Manual approve can be chosen there. Scheduled tasks run without an approval step.
Zoho CRM limits in numbers
Zoho counts API use in credits per organization. Zoho's docs describe API v8, and Ryze AI's facts do not say which API version the tools call, so treat these as Zoho's documented figures and not as observed ones.
| Limit | Figure or rule | Set by |
|---|---|---|
| Daily credit allowance | Per organization over a rolling 24 hours. Free: 5,000. Standard or Starter: 50,000 plus 250 per user license plus add-ons, capped at 100,000. Professional: 50,000 plus 500 per license, capped at 3,000,000. Enterprise or Zoho One: 50,000 plus 1,000 per license, capped at 5,000,000. Ultimate or CRM Plus: 50,000 plus 2,000 per license, uncapped | Zoho |
| What a call costs | 1 credit for most calls. COQL is priced by LIMIT: 1 credit up to 200 rows, 2 up to 1,000, 3 up to 2,000. Writes cost 1 credit for each 10 records, mass deletes 1 credit for each 100, and counting the records of a module costs 50 | Zoho |
| Parallel calls | Per organization and app, by edition: Free 5, Standard or Starter 10, Professional 15, Enterprise or Zoho One 20, Ultimate or CRM Plus 25 | Zoho |
| Heavy-call cap | Every edition allows 10 heavy calls at once: COQL queries, sorted or view-based lists and writes above 10 records. Exceeding it returns TOO_MANY_REQUESTS | Zoho |
| Per-minute throttle | None. Credits and parallel calls are the only meters. Once 50% of the daily credits are gone, responses add an X-API-CREDITS-REMAINING header. A super admin can buy extra credits monthly | Zoho |
| Records per list page | 200 at most. A list call must carry the fields parameter with no more than 50 field API names | Zoho |
| Beyond 2,000 records | page reaches only the first 2,000. After that a page_token is needed, up to 100,000 records, and a token is tied to one user and one request for 24 hours | Zoho |
| COQL result size | LIMIT defaults to 200 and tops out at 2,000. LIMIT with OFFSET covers up to 100,000 records for one set of criteria | Zoho |
| COQL statement size | SELECT takes up to 500 fields, WHERE 25 criteria, ORDER BY 10 fields, GROUP BY 4 fields and an IN list 100 values. SELECT is the only statement. Zoho's limitations page gives more than one figure for lookup joins, so read it before a wide join | Zoho |
| Records per write | 100 at most for insert, update or upsert. If part of a batch fails, Zoho documents HTTP 207 with one result per record in input order | Zoho |
| Automation triggered by writes | Workflows, approvals and blueprints on the module fire for inserts and upserts unless the trigger is switched off. Expect side effects | Zoho |
| Deleting | 100 records per delete call, with workflow rules running by default. The recycle bin holds deleted records for 60 days and then purges them | Zoho |
| Search API | 2,000 records at most, 200 per page, 10 criteria. A freshly created record may be missing, and Zoho points to COQL when delay is not acceptable | Zoho |
| Long text and subforms | Lists shorten rich text fields to 500 characters. Subforms and multi-select lookups appear only on a single-record fetch | Zoho |
| Token lifetime | Access token one hour. Refresh token until revoked, with at most 20 per user | Zoho |
| Ryze AI tool caps | zoho__query returns up to 2,000 rows and zoho__write takes up to 100 records per call, the same as Zoho's own ceilings | Ryze AI |
| Tool wait in Antigravity | 3 minutes per tool call and 5 minutes to connect, adjustable with timeoutSeconds. A wide COQL query has that long to finish | Antigravity |
Sources: Zoho's API limits, get records, COQL query API, COQL limitations, insert records, delete records, search records, access and refresh tokens and recycle bin help page, checked November 14, 2026. The Antigravity figure from the Antigravity MCP documentation, checked November 15, 2026.
First 3 prompts to run
1. Count leads by lead source
Run a COQL query on Zoho CRM that counts the leads created this month and groups them by lead source.
Tools used: zoho__query
What comes back: One row per lead source with a count, using the COUNT and GROUP BY that Zoho documents for COQL.
2. Open deals by closing date
List the open deals in Zoho CRM with deal name, amount, stage, owner and closing date, sorted by closing date.
Tools used: zoho__query
What comes back: One row per open deal with the five fields you named, up to 2,000 rows per call. Owner comes back as a Zoho user unless you ask for the user list as well.
3. Fields of a module before a query
Show the fields of the Leads module in Zoho CRM with their API names, so I can build a query.
Tools used: zoho__read on the settings fields path
What comes back: The field list for the module with each field API name, which COQL and list calls need.
Each answer comes from your own Zoho CRM organization, so this page describes what comes back and shows no sample numbers. Ryze AI has not run this connection inside Antigravity, and no Zoho CRM call was run through the connector for this guide. The prompts follow the tool descriptions in Ryze AI's facts and Zoho's COQL documentation. Report anything that differs to Ryze AI support.
10 jobs to hand to Antigravity
Ten jobs to hand to the Antigravity agent, each with the Ryze AI tool that does the work. The last column follows the pack's reading of the default connection. Every job needs an active Ryze AI plan or trial, and none was run, from Antigravity or from any other client.
| Job | Ask the agent | Tool | Works on the default connection |
|---|---|---|---|
| Lead count by source | How many leads came in this month, per lead source? | zoho__query | Yes. COUNT and GROUP BY are documented COQL features. Not run |
| Open pipeline | Show open deals with amount, stage, owner and closing date, soonest first. | zoho__query | Yes. Not run |
| Deals with account details | Return each deal with fields of its linked account in a single query. | zoho__query | Yes, via lookup-field joins, which Zoho caps per query. Not run |
| Amount per stage | Sum the deal amount for each stage or lead source. | zoho__query | Yes. Zoho documents SUM, AVG, COUNT, MIN and MAX. Not run |
| Field API names | Print the fields of a module with their API names before a query is written. | zoho__read | Yes, with the settings scope. Not run |
| One record in full | Fetch one lead, contact or deal completely by ID. | zoho__read | Yes. Subforms and multi-select lookups come back only on a single-record read. Not run |
| Owner lookup | List the CRM users so owner IDs can be turned into names. | zoho__read | Yes, with the users scope. Not run |
| Batch of new leads | Create leads from the list I paste, 100 per call at most, and report each record's result. | zoho__write | Yes. It changes the CRM, so read the per-record results. Not run |
| Contact upsert | Upsert these contacts so existing ones update and new ones are created. | zoho__write | Yes. Zoho matches on duplicate check fields, Email by default for Leads and Contacts. Not run |
| Remove test data | Delete the test records I list by ID. | zoho__delete | Yes. Deleted records sit in the recycle bin for 60 days. Not run |
Jobs the connection does not cover: adding fields, changing modules or layouts, editing workflow rules, bulk read and bulk write jobs, and anything in Zoho apps other than CRM. Zoho's own pre-built servers list some of these, and none of them was tested with Antigravity.
6 ways to connect Antigravity to Zoho CRM
Six ways can bring Zoho CRM to the Antigravity agent. This guide treats the Ryze AI connector as the main way: Antigravity stores one serverUrl entry, Zoho is signed in once inside Ryze AI and no key is pasted into the config file. Zoho publishes two routes of its own and has no setup page for Antigravity on either. The others were read on their own pages on November 14, 2026 and none was installed for this guide, so the setup column says what each page states and how it would fit mcp_config.json.
| Way | Runs where | Setup | What it reaches in Zoho CRM | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI, one address shared with Claude, ChatGPT and other MCP clients | Connect Zoho CRM in Ryze AI, add a ryze entry with serverUrl https://connector.get-ryze.ai/mcp, sign in | 4 tools covering reads of records, settings, fields and users, COQL queries up to 2,000 rows, writes of up to 100 records and deletes. Records only, one organization per connection | Free to connect. The tools need an active plan or trial: Paid Ads $89 per month with a 7-day free trial, SEO Starter $129 per month, Agency $279 per month |
| Zoho CRM pre-built MCP servers | Hosted by Zoho and switched on in Zoho CRM under Setup > Developer Hub > MCP for AI Agents | Zoho's setup pages cover Cursor, Claude Desktop, VS Code and Windsurf and say any MCP client can use the servers. With no Antigravity page, the mcp_config.json fields and the sign-in are unchecked | Four servers: Data Insights (read and COQL), Data Operations (create, read, update, delete, bulk), Module Customization (custom modules, fields, layouts) and Workflow and Process Automation (workflow rules). No tool counts are given | No price is listed. MCP calls draw on API credits. Zoho described the rollout as phased on April 6, 2026, and its docs do not call it finished |
| Zoho MCP console | Hosted by Zoho. You assemble your own server and copy the URL it produces | Zoho's guides cover Claude, ChatGPT, Cursor, Windsurf and VS Code, and not Antigravity. The URL embeds an API key that Zoho compares to a password. It might fit a serverUrl entry, which was not tried | The tools you pick. Zoho's manual catalogs 1,319 Zoho CRM tools, including read, write and delete. Zoho recommends no more than 300 tools per server | $0 on Zoho's pricing page, drawing on your Zoho API quota. Zoho calls it free for now and promises advance notice of pricing |
| Composio | Hosted by Composio at https://connect.composio.dev/mcp | Add the address as a serverUrl entry and authorize Zoho through Composio's managed OAuth app. Its pages name Claude, ChatGPT and Cursor, with no mention of Antigravity | A Zoho toolkit of 113 tools for reading and writing: COQL, search, notes, tags, attachments, plus workflow rule, custom field and layout tools | Free at $0 with a one-time $2 credit, 3 members and app tool calls ending at 10,000 per month. Standard $18 per seat per month |
| Zapier MCP | Hosted by Zapier | Build a Zapier MCP server, enable the Zoho CRM actions you need and connect. Zapier lists Claude, Claude Code, ChatGPT, Cursor, Codex, Gemini Enterprise, Grok, VS Code, Windsurf and Zed, and not Antigravity | Only the Zoho CRM actions you switch on, for example add tag, convert lead, create or update entries and a beta API request action. No total is printed, and the visible part has no delete action | A successful tool call spends 2 tasks of your Zapier plan. Free $0 with 100 tasks per month; Professional from $19.99 per month |
| Windsor.ai | Hosted by Windsor.ai, with Zoho CRM as a data source | Pick Zoho CRM as a source in Windsor.ai. Its Zoho pages describe ChatGPT and Claude, and no Antigravity setup was opened | Zoho CRM data for analysis: Leads, Deals, Contacts, Accounts, Tasks, Calls, Campaigns, Invoices and custom fields. The pages speak of pulling and analyzing data and never of changing records | Forever Free for 1 user, 1 data source and 1 account, limited to the past 30 days. Basic $23 per month, or $19 per month billed annually |
With a hosted third-party route your Zoho data passes through that vendor. Zoho's pre-built servers reach further than the Ryze AI tools because they list module, field, layout and workflow work, and the Ryze AI route asks for no Zoho setup beyond a sign-in. Two Windsor.ai pages differ on the field count for Zoho CRM, so no count is given here.
Options that do not fit Antigravity
- Zoho CRM connector in Claude's directory. Zoho made a listing titled Zoho CRM there, with one connector URL per region on zohomcp hosts and 41 tools covering organization, modules, fields, layouts, users, records, notes, tags and related records. It is a page of Claude's own directory and says nothing about Antigravity, so it is left out of the table.
- CData zoho-crm-mcp-server-by-cdata. An open source Java server that runs on your own computer and exposes 3 read-only tools: get_tables, get_columns and run_query. It needs a separately licensed CData JDBC driver. Antigravity can start a local stdio server with a command entry, but the setup was not checked for this guide.
- Pipedream. Pipedream lists a Zoho CRM MCP server with 12 actions and no delete action. Its price and its list of chat clients were not read, so it is left out of the table.
- Antigravity's MCP Store and Plugin Marketplace. The IDE installs catalog servers from its MCP Store and the App and CLI from the Plugin Marketplace, open since October 29, 2026. Ryze AI is not one of the 77 servers on Google's MCP page, and no catalog was searched for a Zoho CRM entry.
Which one to pick
Ryze AI is the best way to connect Antigravity to Zoho CRM for running COQL queries and editing records through one URL with only a Zoho sign-in, with four caveats: it was not run inside Antigravity, the tools need a Ryze AI plan once the trial ends, it covers one organization per connection, and fields, modules and workflow rules are out of reach. Pick Zoho's pre-built servers when you need to change modules, fields, layouts or workflow rules and can test the sign-in with Antigravity yourself. Pick the Zoho MCP console when you want to hand-pick tools from Zoho apps beyond CRM. Windsor.ai fits reporting on Zoho data, and Composio and Zapier are hosted options whose Antigravity route is untested. Any of them can sit in the same mcp_config.json under a different name.
Sources: Zoho CRM MCP overview, Zoho CRM MCP FAQ, Zoho MCP, Zoho MCP pricing, built-in MCP announcement, Claude directory listing, Composio Zoho toolkit, Composio pricing, Zapier MCP for Zoho CRM, Zapier pricing, Windsor.ai Zoho CRM page, Windsor.ai pricing, CData server on GitHub and Pipedream Zoho CRM MCP, checked November 14, 2026. Antigravity setup and catalogs from the Antigravity MCP documentation, checked November 15, 2026.
Zoho CRM, Antigravity and MCP: dates that matter
| Date | Event |
|---|---|
| July 17, 2025 | Zoho's press release announced its MCP server: more than 15 tools in early access, with general availability expected toward the end of 2025. |
| December 16, 2025 | A Google Cloud blog post installed Google Cloud MCP servers from the Antigravity MCP Store. It is the earliest dated Google page on Antigravity and MCP the research found. |
| March 9, 2026 | Zoho published its launch post for Zoho MCP. The Zoho CRM listing in Claude's directory is dated March 2026 without a day. |
| April 6, 2026 | Zoho's community post announced built-in MCP support in Zoho CRM, rolling out in phases. |
| May 19, 2026 | Google shipped the Antigravity App and the Antigravity CLI and started moving Gemini CLI users to the CLI. |
| October 2026 | A third-party tracker of the Zoho MCP changelog shows the newest Zoho CRM release adding 95 tools and removing 85, for the US, EU, IN, AU, JP, CA and SA data centers. |
| October 29, 2026 | The Plugin Marketplace opened in the Antigravity App and CLI. |
| November 6, 2026 | Antigravity CLI 1.5.2 fixed MCP OAuth sign-ins that failed with Invalid PKCE code_verifier when a server reconnected during sign-in. |
| November 9, 2026 | Antigravity App 2.30.0 added the Knowledge Work layout, which hides the MCP Servers list, and an import of MCP servers from other coding tools. |
| November 14, 2026 | On this date Zoho's tool manual counted 1,319 Zoho CRM tools, the Claude listing showed 41, Zoho's CRM docs named four pre-built servers and Zoho's MCP pricing page said $0. |
Sources: Zoho press release, Zoho MCP launch post, built-in MCP announcement, Claude directory listing, third-party Zoho MCP changelog tracker, Zoho MCP tool manual, Zoho MCP pricing, checked November 14, 2026; Antigravity changelog, Google Cloud blog, December 2025, Google Developers Blog, May 2026 and Antigravity blog, October 2026, checked November 15, 2026.
How this guide was tested
No call to Zoho CRM was run through the Ryze AI connector for this guide, because no Zoho CRM test account was connected. The four tool names come from Ryze AI's facts and were not seen in a live tool list. The Zoho items below were read from vendor pages on November 14, 2026, and on November 15 the connector's sign-in data was compared with the OAuth order in Google's Antigravity docs.
| Check | Result |
|---|---|
| The four Zoho CRM tool names | Taken from Ryze AI's facts. Not loaded from a live connector. |
| Zoho CRM API v8 docs | Read for every scope, limit, credit figure, error and the recycle bin rule used here. |
| Zoho CRM MCP overview, setup pages and Zoho MCP pages | Read for the pre-built servers and the Zoho MCP console, including pricing and sign-in. |
| Connector sign-in data, November 15 | The address answers HTTP 401 without a sign-in. Its discovery files list the scopes mcp:read and mcp:write, a registration endpoint, no metadata document support and PKCE with S256, which fits Antigravity's third route, dynamic client registration. The path-specific discovery file names the same resource as the server URL, which Antigravity requires. |
| Claude listing, Composio, Zapier, Windsor.ai and CData pages | Read for the comparison. Their tool counts and prices are as the pages printed them. |
| Google's Antigravity pages | Read for the config file, transports, sign-in, approvals, timeouts and dated facts used here. |
Not run for this guide: any Zoho CRM call and anything inside Google Antigravity. The IDE, the App and the CLI were not opened, no Ryze AI sign-in was completed from them, and Zoho's consent screen was not seen. The setup, sign-in and approval steps follow Google's Antigravity documentation as read on November 15, 2026. Whether Antigravity follows the path-specific discovery address or adds the server path itself is not stated by Google and was not tested.
Antigravity and Zoho CRM errors and fixes
Messages documented by Zoho and Google
No error was observed in a test, so none of the messages below was seen from the Ryze AI connector. The Zoho entries are errors Zoho documents for the CRM API, in Zoho's wording. The Antigravity and Ryze AI entries come from Google's pages or Ryze AI's facts and say so.
- REQUIRED_PARAM_MISSING (HTTP 400): One of the expected parameters is missing.
- Zoho documents this for a list request that lacks the fields parameter. Name up to 50 field API names, or switch to a COQL query.
- LIMIT_EXCEEDED (HTTP 400): Fields limit exceeded.
- Zoho documents this when the fields parameter carries more than 50 API names. Request fewer fields.
- DISCRETE_PAGINATION_LIMIT_EXCEEDED (HTTP 400): You can only get the first 2000 records without using page_token param.
- Zoho documents this for page-based paging beyond 2,000 records. Use the page token Zoho returns, good for 24 hours, or tighten the criteria.
- EXPIRED_VALUE (HTTP 400): The token given has expired.
- Zoho documents this for a page token older than 24 hours. Begin the listing again.
- NO_PERMISSION (HTTP 403): Permission denied to read records
- Zoho documents this when the connecting user may not read that module. A Zoho admin can adjust that user's profile, or someone with access can reconnect.
- TOO_MANY_REQUESTS (HTTP 429)
- Zoho documents this when the daily credits are spent or too many calls overlap. Wait, run fewer calls in parallel, or ask a super admin to buy credits.
- DUPLICATE_DATA (HTTP 400): duplicate data
- Zoho documents this when a write repeats a value in a unique field. Upsert instead, which matches on the duplicate check fields, or change the value.
- LIMIT_REACHED (HTTP 400): Maximum response iteration limit reached
- Zoho documents this when a search matches over 2,000 records. Narrow the search or move to COQL.
- A write returns 200 yet a record failed
- Per Ryze AI's facts a 200 write response can carry errors for single records, and Zoho documents HTTP 207 with one result per record for partial success. Read every record's result.
- The server never finishes connecting
- Antigravity waits up to 5 minutes for a server to connect. Confirm mcp_config.json is valid JSON and that the entry uses serverUrl (or url), not httpUrl, then reload the configuration.
- Authenticate does nothing in the App
- Complete the Ryze AI sign-in in the browser, copy the authorization code shown there, paste it into Enter authorization code and click Submit.
- The MCP Servers section is missing in the App
- The App is in the Knowledge Work layout. Choose Software Engineering under Settings > General > Interface Layout.
- The Zoho tools are not listed
- The tool list may be cached from before Zoho CRM was connected. Delete the ryze entry, add it back and open a new chat. Check the Zoho CRM card in Ryze AI shows Connected.
- Every call asks for approval
- That is Ask mode, Antigravity's default for MCP tools with no rule. Allow chosen tools with the mcp(server/tool) form.
- A subscription message or empty data comes back
- The Zoho CRM tools need an active Ryze AI plan or free trial, and Zoho CRM must read Connected under Integrations in Ryze AI. Start the trial and retry.
- A second Zoho CRM organization is needed
- Click View on the Zoho CRM card in Ryze AI and choose Add one more account. The primary organization answers unless the prompt names another.
Terms on this page
- MCP (Model Context Protocol)
- An open standard through which an AI model such as the Antigravity agent calls tools on outside servers.
- mcp_config.json
- The file in which Antigravity lists its MCP servers under mcpServers, either globally in ~/.gemini/config or per workspace in .agents.
- COQL
- CRM Object Query Language, Zoho CRM's SQL-like SELECT language. It uses module and field API names and can join modules through lookup fields.
- API credit
- The unit Zoho CRM counts API use in. Most calls cost 1 credit, and each edition has an allowance for a rolling 24-hour window.
- Module and API name
- A module is a record type such as Leads, Contacts or Deals. Calls and COQL use the API names of modules and fields, which are not always the labels shown in the CRM.
- Page token
- The value Zoho returns as next_page_token. It is needed to list more than 2,000 records, belongs to one user and expires after 24 hours.
- Ask mode
- Antigravity's default for an MCP tool that has no rule: each call waits until you approve it.
Sources: COQL overview, API limits, get records, modules API, checked November 14, 2026; Antigravity MCP documentation, checked November 15, 2026.
Frequently asked questions
How do I connect Antigravity to Zoho CRM?
Connect Zoho CRM in Ryze AI with its Zoho sign-in, then add a ryze entry with the serverUrl https://connector.get-ryze.ai/mcp to Antigravity's mcp_config.json and complete the Ryze AI sign-in.
Is there a Zoho CRM connector for Antigravity?
Yes, one is the Ryze AI connector at https://connector.get-ryze.ai/mcp, added as one serverUrl entry. Zoho's own setup pages name Claude Desktop, Cursor, VS Code and Windsurf, and none names Antigravity.
Is there a Zoho CRM MCP server for Antigravity?
Zoho runs pre-built MCP servers inside Zoho CRM and an MCP console for building your own, but neither has a documented Antigravity setup. Whether they work with Antigravity's sign-in was not tested here. The Ryze AI connector is a hosted server with 4 Zoho CRM tools that fits Antigravity's dynamic client registration route.
What is a Zoho MCP server?
A server that lets an AI client such as Antigravity call Zoho tools over the Model Context Protocol. Zoho MCP is also the name of Zoho's own product covering many Zoho apps, while the Ryze AI connector covers Zoho CRM only, with tools to read, query, write and delete records.
Where is the Antigravity MCP config file?
The global file is ~/.gemini/config/mcp_config.json and a workspace file is .agents/mcp_config.json. In the IDE, open the ... menu in the agent panel, then MCP Servers, Manage MCP Servers and View raw config.
Which Antigravity plan do I need for MCP?
No particular plan: Google's Antigravity MCP documentation names none. The setup is the same in the IDE, the App and the CLI, apart from how the sign-in starts.
Does Antigravity need a client ID for the Ryze AI connector?
No. Antigravity runs OAuth 2.0 with PKCE and registers itself with servers that support dynamic client registration, which the Ryze AI connector does. The Zoho sign-in is separate and happens in Ryze AI.
What Zoho CRM permissions do I need?
A Zoho user whose profile allows API access, since Zoho's COQL page lists Zoho CRM API Access as required. The connection asks for modules and settings scopes with all operations, read access to users and the organization, and COQL read. The connecting user's own Zoho CRM permissions still apply on top of those scopes.
Can Antigravity change my Zoho CRM data?
Yes, for records. zoho__write creates, updates or upserts up to 100 records per call. In Antigravity each call waits for your approval until you allow the tool, and no write call was run for this guide.
Can Antigravity delete records in Zoho CRM?
Yes. zoho__delete deletes records singly or in bulk, and Zoho keeps deleted records in the recycle bin for 60 days before they are permanently deleted. Keep the tool in Ask mode, or list it under disabledTools to hide it.
Can Antigravity create fields or edit workflow rules in Zoho CRM?
Not through the Ryze AI connector, whose write tool covers records only. Zoho's pre-built Module Customization server lists custom modules, fields and layouts, and its Workflow and Process Automation server lists workflow rules. Neither was tested with Antigravity.
Can I connect more than one Zoho CRM organization?
Yes. A Ryze AI workspace can hold several Zoho CRM organizations: click View on the Zoho CRM card and choose Add one more account. One is the primary and is used unless you name another, and the tools accept an optional connection_id.
How many records can a query return at once?
A COQL query returns up to 2,000 rows per call, and a list call returns up to 200 records per page. Past 2,000 records, page-based listing stops and Zoho asks for a page token, which reaches 100,000 records. A COQL call costs 1 credit for up to 200 rows, 2 for up to 1,000 and 3 for up to 2,000.
Does the Antigravity CLI work with the connector?
The CLI reads the same mcp_config.json files, and /mcp opens the MCP Manager to check status and reload. Google lists no CLI sign-in steps, so this guide gives none, and the connector was not tested inside Antigravity.
How much does it cost?
Connecting costs nothing, but the 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. Zoho API credits depend on your Zoho edition.
How do I disconnect Zoho CRM from Antigravity?
Delete the ryze entry from mcp_config.json, or set disabled: true to pause it. Zoho says users can revoke a client's delegated access at any time. Ryze AI's facts describe no disconnect step for Zoho CRM, so ask Ryze AI support if you need the connection removed on the Ryze AI side.