By Ira Bodnar, Ryze AI · Updated · Connector tested November 17, 2026
Quick answer
The main way to connect VS Code to Zoho CRM is the Ryze AI connector. Click Connect on the Zoho CRM card in Ryze AI and approve access in Zoho. Then, with Copilot as the session target, run Chat: Open Customizations, select MCP Servers and add an HTTP server with https://connector.get-ryze.ai/mcp and the server ID ryze. Trust it and finish the Ryze AI sign-in in your browser. Copilot Chat then has 4 Zoho CRM tools for reading records, running COQL queries, writing records and deleting them.
- 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 VS Code run Chat: Open Customizations, select MCP Servers and add an HTTP server with the connector URL
- Trust the server, sign in to Ryze AI and ask Copilot Chat about your CRM records
VS Code to Zoho CRM at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, kept in VS Code as one HTTP MCP server called ryze |
| Server address | https://connector.get-ryze.ai/mcp, the same for every user |
| Where it goes in VS Code | Chat: Open Customizations > MCP Servers > Add Server (+), or the MCP: Add Server command. A personal entry lands in Copilot Global, ~/.copilot/mcp-config.json |
| Sign-in from VS Code | OAuth in the browser, run by VS Code. No Zoho token, key or client secret is typed into VS Code |
| Sign-in to Zoho | Zoho OAuth, started from the Zoho CRM card in Ryze AI. It works on any Zoho data center and renews by itself |
| Zoho CRM tools | 4: two read (zoho__read, zoho__query), one write (zoho__write creates, updates or upserts records) and one delete (zoho__delete, into the recycle bin) |
| Can Copilot change records | Yes, through the write and delete tools. The write tool is documented for records, not for fields, layouts or workflow rules. A new VS Code session starts on Manual permissions, which show a call that is not auto-approved before it runs |
| Copilot plan | GitHub lists MCP in every Copilot plan. Business and Enterprise seats also need the MCP servers in Copilot policy, which ships off |
| Ryze AI price | Paid Ads is $89 per month with a 7-day free trial. Adding the connector is free |
| Zoho's own options for VS Code | Four pre-built servers inside Zoho CRM with an Install MCP Server in VS Code button, and the Zoho MCP console with an Add to VS Code button. Zoho's connector in Claude's directory names Claude only |
| Last tested | November 17, 2026, from outside: the connector's 401 reply and its two sign-in discovery files. No Zoho CRM call and no step inside VS Code was run |
Before you start
- GitHub Copilot in a current VS Code. GitHub's MCP article asks for Copilot access and VS Code 1.99 or later. The steps below save the server to Copilot Global, which came with VS Code 1.140, so update an older install first. A GitHub account that is eligible but has no plan is enrolled in Copilot Free when it signs in to VS Code.
- The MCP policy, when Copilot comes from an organization. On Copilot Business or Copilot Enterprise through an organization or enterprise, the MCP servers in Copilot policy must be on. GitHub ships it off, so an administrator has to enable it. Copilot Free, Pro, Pro+ and Max are outside that policy.
- A local folder, with Copilot as the session target. Microsoft's walkthrough wants AI features switched on, a local folder open and Copilot picked in the Session Target dropdown before a server is added.
- 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). Zoho lists the profile permission Zoho CRM API Access as required for COQL queries.
- 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 VS Code to Zoho CRM with the Customizations editor
The first two steps happen in Zoho and Ryze AI, the other four in VS Code. 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.
Open the MCP Servers list in VS Code
Open a local project folder and pick Copilot in the Session Target dropdown, because the editor shows the servers of the selected harness. Run Chat: Open Customizations from the Command Palette, select MCP Servers and choose Add Server (+) in the User group.
Add the HTTP server
Choose HTTP (HTTP or Server-Sent Events) and enter https://connector.get-ryze.ai/mcp. Type ryze as the server ID. For a personal setup select Global, then Copilot Global. There is no client ID or secret to enter.
Trust the server and sign in
Read the trust prompt before you accept it, then finish the Ryze AI sign-in in the browser. If no sign-in page opens, use the ellipsis (...) beside ryze in MCP Servers and choose Authenticate. On the Ryze AI page pick the workspace that holds your Zoho CRM connection and click Allow connection.
Ask your first question in Copilot Chat
Open Copilot Chat and ask: List the fields of my Leads module in Zoho CRM, with each API name and type. Approve the tool call if VS Code asks, then expand it in the conversation to confirm the ryze server answered. Microsoft's docs point out that a reply with no tool call does not prove the connection works.
The Ryze AI help center page for Zoho CRM covers the Zoho side of the connection, and the VS Code MCP servers documentation covers the editor side.
Sources: VS Code MCP servers, GitHub: extend Copilot Chat with MCP, GitHub Copilot plans, Ryze AI help center page for Zoho CRM. Checked November 14, 2026.
Command Palette and config files
The Customizations editor, the guided command and the config files all end in the same server entry. Pick the one that matches how you manage VS Code. Nothing changes on the Zoho side.
Guided flow
Run MCP: Add Server from the Command Palette and answer the prompts with the same URL and the server ID ryze. It skips the Customizations editor.
Portable config file
To write the entry yourself, use the portable format that the Copilot harness reads. It lives in ~/.copilot/mcp-config.json for you alone ($COPILOT_HOME/mcp-config.json when that variable is set) or in .mcp.json at the workspace root, and both start with mcpServers. Microsoft's portable HTTP examples all include a tools field, so this one does too:
{
"mcpServers": {
"ryze": {
"type": "http",
"url": "https://connector.get-ryze.ai/mcp",
"tools": ["*"]
}
}
}Older VS Code format
The earlier format uses the key servers in .vscode/mcp.json or the profile mcp.json. It serves the Local harness, which VS Code 1.146 deprecated on November 11, 2026, with removal announced for February 2027. Copilot harness sessions do not read these files directly, and Microsoft's MCP developer guide calls them deprecated destinations in the guided flow. Many older tutorials still show this shape:
{
"servers": {
"ryze": {
"type": "http",
"url": "https://connector.get-ryze.ai/mcp"
}
}
}Limits of VS Code to know
- The type field sets the transport: http for Streamable HTTP, stdio for a local command and sse for older endpoints that Microsoft labels legacy. The ryze entry uses http.
- Trusting a server lets it start, signing in gives it access, and approving covers single tool calls. VS Code treats the three as separate steps.
- Old-format entries that rely on ${input:...} or ${command:...} prompts are not forwarded to Copilot harness sessions.
- Copilot Global does not sync to your other machines, and a remote host or Dev Container does not read the local file. Add the server on the machine where the session runs.
- Microsoft's MCP developer guide says VS Code signs in to providers other than GitHub and Microsoft Entra through Dynamic Client Registration or a pre-registered OAuth client, and the connector publishes a register endpoint. Ryze AI was not tried inside VS Code for this guide. If the sign-in does not start, email Ryze AI support with the link at the end of the page.
VS Code, Copilot and MCP in one table
| Topic | What Microsoft and GitHub document |
|---|---|
| Screen for adding a server | Chat: Open Customizations opens the Agent Customizations editor. Its MCP Servers page has Add Server (+), and the Chat title bar and the Agents window sidebar lead to the same editor |
| Files the Copilot harness reads | ~/.copilot/mcp-config.json (Copilot Global) for one person, and .mcp.json at the workspace root for a shared setup, each with a top-level mcpServers object |
| Legacy files | .vscode/mcp.json and the profile mcp.json with a servers object, kept for the deprecated Local harness |
| Transports | stdio starts a command, http speaks Streamable HTTP, and sse reaches older endpoints without Streamable HTTP |
| Sign-in | When a server asks for OAuth, the Copilot runtime hands the sign-in to VS Code, which stores the credentials. GitHub and Microsoft Entra are built in. Other providers use Dynamic Client Registration or a pre-registered client, and the portable format has a flat oauthClientId field for the second case. Redirects go to http://127.0.0.1:33418 or https://vscode.dev/redirect |
| Keys and headers | HTTP entries accept a headers object whose values can read environment variables as ${NAME}. The portable files ignore input prompts, envFile and SecretStorage |
| Tool approval | New sessions start on Manual permissions, which show the tool name and its inputs for any call that is not auto-approved. The chat input dropdown also offers Assisted permissions, where an LLM judges each call, and Allow all. Autopilot approves every tool |
| Plan | GitHub includes MCP on Copilot Free, Student, Pro, Pro+, Max, Business and Enterprise. Business and Enterprise seats additionally need the MCP servers in Copilot policy, off by default |
| Admin controls | allowedMcpServers and deniedMcpServers in enterprise-managed settings match a server by URL, command or name, and a local file cannot lift a block. chat.mcp.access set to none turns MCP off |
| Managing a server | Each entry in MCP Servers has a toggle and an ellipsis menu with Start, Stop, Enable or Disable, Uninstall and Show Output, plus Authenticate when a sign-in is pending. MCP: List Servers offers the same actions |
| Tool cap | 128 enabled tools per chat request. Past that, VS Code answers Cannot have more than 128 tools per request. |
Sources: VS Code MCP servers, VS Code MCP configuration reference, VS Code: manage MCP servers, VS Code MCP developer guide, VS Code tool approvals, VS Code agent harnesses, VS Code enterprise AI settings, GitHub: extend Copilot Chat with MCP, GitHub Copilot plans. Checked November 14, 2026.
Other editors and assistants
The same URL works in other MCP clients. Zoho CRM is approved once in Ryze AI, so nothing changes on the Zoho side.
Cursor
Cursor has its own mcp.json and its entries use mcpServers with a url field, where the older VS Code format uses servers. Check the key before you move a file from one editor to the other. How to connect Cursor to Zoho CRM.
Claude
Claude takes the same URL under Customize, Connectors. Added the connector before Zoho CRM was connected? Remove and re-add it so the tool list refreshes. How to connect Claude to Zoho CRM.
ChatGPT
ChatGPT takes the same URL as a custom MCP app. Its plan rules differ from Copilot's, so follow its own guide. How to connect ChatGPT to Zoho CRM.
Zoho CRM access and the scopes Ryze AI requests
Two sign-ins are involved: Zoho's, done once in Ryze AI, and the Ryze AI sign-in that VS Code starts. Four things decide what Copilot Chat can reach in Zoho CRM.
- 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 Copilot can change
- The tool set includes write and delete tools, so Copilot 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 VS Code asks first
- A server saved in Copilot Global may ask for your trust before it starts, and may ask again after its entry changes. Manual permissions then hold each Zoho CRM call that is not auto-approved, with the tool name and inputs on screen.
- Who you are in Zoho
- The Zoho CRM role of the login you connect still applies below the scopes. Zoho answers NO_PERMISSION (HTTP 403) when that user may not read a module.
The five Zoho scopes
The Zoho sign-in asks for the five OAuth scopes below, as listed in the Ryze AI documentation. Zoho spells a scope as service, scope name and operation type, and the operation ALL allows every operation. The middle column follows Zoho's API v8 pages; the last says what the Ryze AI tools do with each scope when Copilot Chat calls them.
| OAuth scope | What Zoho says it covers | Use in Copilot Chat through Ryze AI |
|---|---|---|
| ZohoCRM.modules.ALL | Reading, creating, updating and deleting records in every module: standard ones such as Leads, Contacts, Accounts, Deals, Tasks, Products, Quotes and Invoices, and custom modules | Behind all four tools: record reads, COQL results, writes and deletes |
| ZohoCRM.settings.ALL | Every settings area Zoho lists, from fields, layouts and modules to custom views, tags, territories, roles, profiles and currencies | Lets zoho__read fetch the field list and module metadata a query needs. The Ryze AI write tool is documented for records only, so this guide claims no settings changes |
| ZohoCRM.users.READ | Fetching all users or one user. Changes to users fall outside it | Turning the owner IDs in a result into names |
| ZohoCRM.org.READ | Fetching the organization's details. Changes to the organization fall outside it | Reading the organization details with zoho__read |
| ZohoCRM.coql.READ | Sending COQL queries. Zoho expects a modules scope beside it, and a fields scope for field metadata | Needed by zoho__query |
Left out of the request: the ZohoCRM.bulk scopes that Zoho's Bulk Read and Bulk Write APIs need, the ZohoCRM.notifications scopes, and any write access to users or the organization, since both are requested as READ. This comes from setting the five scopes beside Zoho's scope list; the Zoho consent screen itself was not seen for this guide.
Scopes set the ceiling. Zoho opens the Notes module to admin users only and names the profile permission Zoho CRM API Access as a requirement for COQL. Zoho issues tokens for one organization at a time, while Ryze AI keeps several organizations in one workspace, one of them primary.
Sources: Zoho CRM API v8 scopes, Zoho CRM API v8 get records, Zoho CRM API v8 COQL overview, Ryze AI help center page for Zoho CRM. Checked November 14, 2026.
Removing access
To stop access from VS Code, open Chat: Open Customizations, select MCP Servers and disable or uninstall the ryze server from its ellipsis menu. Stop is weaker, since it ends the current run and a later request can start the server again. On the Zoho side, Zoho's OAuth documentation says a user can revoke a client's delegated access at any time. The Ryze AI documentation used for this guide describes no disconnect step on the Zoho CRM card, so none is given here.
What Copilot Chat 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 the Ryze AI app source and have not yet been seen in a connected workspace. Each tool takes an optional connection_id for an organization other than the primary one. Writes and deletes are separate tools, so VS Code can ask about them on their own.
| 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 Copilot to check each record in the result. The tools work only while the Ryze AI workspace has an active plan or free trial.
A new VS Code session uses Manual permissions unless a setting or an organization default says otherwise, so a Zoho CRM call that is not auto-approved shows its tool name and inputs before it runs. Watch Chat: Manage Tool Approval, because its top-level checkbox for ryze trusts every tool on the server, zoho__delete included. Setting a tool to false in chat.tools.eligibleForAutoApproval keeps it on manual approval, while Allow all and Autopilot approve everything. The Ryze AI chat itself starts on Skip all approvals, and its Tool approvals picker can switch to Approve write & delete or Manual approve. Scheduled tasks run without an approval step.
Limits in numbers
Zoho's API decides how much one call from Copilot Chat can carry. These figures come from Zoho's API v8 pages and, for the recycle bin, its help center; the Ryze AI documentation does not say which API version its tools call. Two of them are also the tools' own caps: 2,000 rows per query and 100 records per write. On the VS Code side, a chat request takes 128 enabled tools at most.
| Limit | Number | Zoho page |
|---|---|---|
| Rows from one COQL query | The default is 200 rows without a LIMIT, and the ceiling is 2,000. LIMIT with OFFSET can reach 100,000 records for one set of criteria. Beyond that Zoho suggests filtering on the record ID or using the Bulk Read API | COQL overview |
| Size of one COQL query | Up to 500 fields in SELECT, 25 conditions in WHERE, 10 fields in ORDER BY, 4 in GROUP BY, 5 aggregate fields and 100 values in IN or NOT IN. Only SELECT is allowed, multi-line fields such as Description cannot be filtered, and the number of lookup joins has a cap | COQL limitations |
| Records per list page | 200, which is both the default and the ceiling for per_page | Get records |
| Field names in a list call | Required when fetching all records, 50 at most | Get records |
| Paging | The page parameter stops at record 2,000. Beyond it a page token takes over, up to record 100,000. Each token belongs to one user and one set of parameters, and expires after 24 hours | Get records |
| Records per write | 100 per insert, update or upsert call, with a duplicate check on unique fields at every insert | Insert records |
| Mixed results in a batch | HTTP 207 Multi-Status, with one result per record in the order they were sent | Insert records |
| Automation on writes | Workflows, approvals and blueprints attached to the module fire on insert and upsert, unless the request sends the trigger key as an empty list | Upsert records, Insert records |
| Records per delete | 100 per call. Workflow rules fire on delete by default, and subforms are deleted with their record | Delete records |
| Recycle bin | 60 days to restore a deleted record, after which Zoho removes it permanently | Recycle bin |
| Search | At most 2,000 records, 200 per page and 10 criteria. A record saved seconds ago can be missing until Zoho indexes it, and Zoho points to COQL for results with no delay | Search records |
| Long text and subforms in lists | Rich text fields are cut to their first 500 characters. Subforms and multi-select lookups come back only when one record is read | Get records |
| Zoho access token | 1 hour, renewed with a refresh token that lasts until the user revokes it | Token validity |
Zoho API credits
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.
| Budget | What Zoho documents |
|---|---|
| Credits per rolling 24 hours | The count is kept per organization. Free edition: 5,000. Standard/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/Zoho One: 50,000 plus 1,000 per license, up to 5,000,000. Ultimate/CRM Plus: 50,000 plus 2,000 per license, no ceiling. Purchased add-on credits are added on top |
| Credits per call | Most calls cost 1. A COQL query costs 1 with a LIMIT up to 200, 2 up to 1,000 and 3 up to 2,000. A write costs 1 per 10 records and a mass delete 1 per 100, while Convert Lead costs 5 and counting a module's records costs 50 |
| Calls running at once | Counted per organization and app: Free 5, Standard/Starter 10, Professional 15, Enterprise/Zoho One 20, Ultimate/CRM Plus 25. A separate cap of 10 applies in every edition to COQL, writes of more than 10 records, sorted lists or lists read through a custom view, Convert Lead and the Composite API. Zoho sets no per-minute limit |
| Running out | Zoho answers HTTP 429 with TOO_MANY_REQUESTS. After half of the day's credits are gone, each reply carries an X-API-CREDITS-REMAINING header. A super admin can raise the ceiling in the API Dashboard and pays monthly for the credits used |
Sources: Zoho CRM API v8 limits, Zoho CRM API v8 COQL overview, Zoho CRM API v8 COQL limitations, Zoho CRM API v8 get records, Zoho CRM API v8 insert records, Zoho CRM API v8 delete records, Zoho CRM recycle bin, Zoho CRM API v8 status codes, VS Code tools, Ryze AI help center page for Zoho CRM. Checked November 14, 2026.
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 Copilot Chat. 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 Copilot 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. Read each write or delete call in the approval prompt before you allow it.
10 jobs to hand to Copilot Chat
Ten jobs to type into Copilot Chat once the ryze server is running, each with the Zoho CRM tool it calls. None was run for this guide, because no Zoho CRM organization was connected for testing. The last column says whether the five scopes of the default connection cover the job, going by Zoho's documentation.
| Job | Ask Copilot | Tool | On the default connection |
|---|---|---|---|
| Leads per source | Count this month's new Leads per Lead_Source with a COQL GROUP BY. | zoho__query | Yes |
| Closing soon | Show open Deals with Amount, Stage, Owner and Closing_Date, ordered by Closing_Date. | zoho__query | Yes |
| Deal plus account | In one COQL query, return each open deal with the Industry of its linked account. | zoho__query | Yes, within Zoho's cap on joins per query |
| Pipeline totals | Total the Amount of open deals by Stage with SUM and GROUP BY. | zoho__query | Yes. Zoho documents SUM, AVG, COUNT, MIN and MAX in COQL |
| Check API names | Before you write any query, read the Leads fields and give me each API name and type. | zoho__read | Yes |
| Map owners | Read the CRM users and match each owner ID in the last result to a name. | zoho__read | Yes |
| Full record | Read the contact with this ID in full, subforms included. | zoho__read | Yes. Zoho returns subforms only on a single-record read |
| Import leads | Create these leads from the list below and report each record's result. | zoho__write | Yes, 100 per call, with Copilot's approval prompt unless the tool is auto-approved |
| Sync contacts | Upsert these contacts on Email, so existing ones update and new ones are created. | zoho__write | Yes. Zoho matches Contacts on Email by default |
| Clear test leads | Delete the test leads I list here by ID. | zoho__delete | Yes. Zoho keeps them in the recycle bin for 60 days |
5 ways to connect VS Code to Zoho CRM
Five ways can put Zoho CRM in Copilot Chat in VS Code. Zoho's own pages name VS Code for the two Zoho routes and Zapier lists VS Code among its clients; for Composio, the pages read give no VS Code steps. This guide treats the first, the Ryze AI connector, as the main way: one Zoho approval in Ryze AI, one address in VS Code, and separate tools for reading, writing and deleting. The other four were read on their vendors' pages on November 14, 2026 and were not set up in VS Code for this guide.
| Way | Runs where | Setup in VS Code | What it reaches in Zoho CRM | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI. One address, also used by Claude, ChatGPT and Cursor | Chat: Open Customizations > MCP Servers > Add Server with an HTTP entry for the address, then the sign-in in the browser | Records in every module through 4 tools: reads, COQL up to 2,000 rows, writes of up to 100 records and deletes into the recycle bin. Several organizations in one workspace | Paid Ads is $89 per month with a 7-day free trial. Adding the connector is free |
| Zoho CRM's pre-built MCP servers | Hosted by Zoho | In Zoho CRM open Setup > Developer Hub > MCP for AI Agents, pick a server, choose VS Code and click Install MCP Server in VS Code, then Install, Allow and open the authentication URL. By hand, Zoho's page says to run MCP: Open User Configuration, add the server under a servers object with a url and type http, reload the window and click Start Server. That is the older file format that VS Code now labels deprecated | Four servers that can be installed side by side: Data Insights (read-only COQL and schemas), Data Operations (create, read, update and delete, bulk and related records), Module Customization (modules, fields, layouts) and Workflow & Process Automation (workflow rules and tasks). Each stays inside your CRM role | No price on Zoho's pages. Calls spend API credits like any other API call |
| Zoho MCP console, a server you build | Hosted by Zoho | Add Zoho CRM tools to a server in the console, then in its Connect section choose VS Code and click Add to VS Code. By hand, Zoho says to use MCP: Add Server in Agent mode, choose HTTP, paste the MCP URL, name it and authorize. The MCP URL carries an API key, so Zoho says to guard it like a password | The tools you pick: Zoho's Tool Manual lists 1,319 for Zoho CRM among 76 services. Zoho recommends at most 300 tools per server and about 100 for best performance, and VS Code allows 128 enabled tools per chat request. With Authorization on Demand each user signs in with their own Zoho account | $0 for now, according to Zoho, on the API quota you already have, with notice before any pricing |
| Zapier MCP | Hosted | Zapier's quickstart lists VS Code among its more clients, with a connection token for clients that have no setup page of their own. Switch on the Zoho CRM actions you want. It needs a Zapier account | The actions you enable, such as Create Module Entry, Update Module Entry, Convert Lead, Add Tag and API Request (Beta). The visible part of the list has no delete action | 2 Zapier tasks per successful call, none for a failed one. Free gives 100 tasks a month; Professional starts at $19.99 a month |
| Composio | Hosted | Its Zoho page does not name VS Code, and the pages read give setup steps only for Claude and Claude Code. Composio does appear on GitHub's list of Copilot connectors, but whether that connector reaches Zoho CRM was not checked. Zoho signs in through Composio's managed OAuth app or one of your own | 113 Zoho CRM tools: records, COQL, search, notes, tags, attachments, workflow rules, custom fields, layouts, functions and users | Free ends at 10,000 tool calls a month. Standard is $18 per seat per month, and extra calls cost $0.005 each |
Options that do not fit VS Code
- GitHub Copilot connectors. VS Code's Browse page lists GitHub-managed connectors, in preview, for 26 services on November 14, 2026. Zoho CRM is not one of them, and the connector page sends you to add an MCP server by URL for any service that is missing.
- The Zoho CRM connector in Claude's directory. Made by Zoho, labeled Anthropic verified, with 41 tools and an address per region. The listing is a page of Claude's own directory and speaks only about Claude, so it carries no VS Code setup. For VS Code, Zoho's install button sits on the pre-built servers in the second row.
- Windsor.ai. Its Zoho CRM pages give setup for ChatGPT and Claude only, and they describe pulling data for analysis without saying the connector can change records.
- CData's open-source Zoho CRM server. A local, read-only Java server over stdio with 3 tools, which needs a separately licensed CData JDBC driver. Its README sets it up for Claude Desktop. VS Code can start local servers, but this guide did not try this one there.
- Small GitHub servers. Of the 36 repositories a GitHub search returned for zoho crm mcp, the most starred (14 stars) builds a demo server with a single add tool and calls nothing in Zoho CRM. The others have 4 stars or fewer.
Which one to pick
Ryze AI is the best way to connect VS Code to Zoho CRM for COQL reporting and record edits across several Zoho CRM organizations, from one address that Claude, ChatGPT and Cursor share, with one caveat: its write tool covers records only, so new fields, layouts and workflow rules need Zoho's own servers. Zoho's pre-built servers need no building, since Zoho CRM installs them in VS Code with one button, and Module Customization and Workflow & Process Automation are the two to add when an admin reshapes the CRM. The Zoho MCP console suits one server that mixes Zoho CRM with other Zoho apps or third-party tools, as long as the enabled tools stay under VS Code's 128 per request. Zapier and Composio fit teams that already run them for other apps. A Zoho server and the ryze server can sit side by side in Copilot Global.
Sources: Zoho CRM MCP servers overview, Zoho CRM MCP setup for VS Code, Zoho MCP implementation guide, Zoho MCP FAQ, Zoho MCP pricing, Zoho CRM connector in Claude directory, Zoho community: built-in MCP support, Zapier MCP for Zoho CRM, Zapier MCP quickstart, Zapier MCP usage, Zapier pricing, Composio Zoho toolkit, Composio pricing, CData Zoho CRM MCP server, GitHub supported connectors, Ryze AI help center page for Zoho CRM. Checked November 14, 2026.
Zoho CRM, Copilot and MCP: dates that matter
| Date | What happened |
|---|---|
| April 4, 2025 | VS Code 1.99, the March 2025 release, came out with MCP server support in agent mode. GitHub's changelog entry on Copilot in 1.99 carries this date. |
| July 14, 2025 | GitHub called MCP in VS Code generally available and moved organization access to the MCP servers in Copilot policy, off by default. |
| July 17, 2025 | A Zoho press release announced Zoho's own MCP server in early access, with more than 15 Zoho tools and general availability expected towards the end of 2025. |
| March 9, 2026 | Zoho's blog post launching Zoho MCP went up. It was last updated on March 10, 2026. |
| March 2026 | Zoho's Zoho CRM connector appeared in Claude's directory. The listing gives only the month. |
| April 6, 2026 | Zoho's community post announced MCP servers built into Zoho CRM, the ones with the VS Code install button, rolling out to data centers in phases. Zoho's docs read on November 14, 2026 do not say whether every data center has them yet. |
| September 30, 2026 | VS Code 1.140 added Copilot Global and the workspace .mcp.json as destinations in MCP: Add Server. |
| October 2026 | The latest Zoho CRM release in the Zoho MCP changelog added 95 tools and removed 85, for the US, EU, IN, AU, JP, CA and SA data centers. |
| October 22, 2026 | VS Code 1.143 made the Copilot harness the default for new sessions. |
| October 28, 2026 | VS Code 1.144 and GitHub opened Copilot connectors in preview with 26 services. Zoho CRM was not among them on November 14, 2026. |
| November 11, 2026 | VS Code 1.146 deprecated the Local harness that reads .vscode/mcp.json, with removal announced for February 2027. |
| November 14, 2026 | The day the Zoho sources were read: 1,319 Zoho CRM tools in Zoho's Tool Manual, 41 on the Claude directory listing, four pre-built servers in Zoho's docs, and $0 on the Zoho MCP pricing page. |
Sources: VS Code 1.99, GitHub changelog, April 4, 2025, GitHub changelog, July 14, 2025, VS Code 1.140, VS Code 1.143, VS Code 1.144, GitHub changelog, October 28, 2026, VS Code 1.146, Zoho press release, July 17, 2025, Zoho blog, March 9, 2026, Zoho MCP changelog, Zoho community: built-in MCP support, Zoho CRM connector in Claude directory. Checked November 14, 2026.
How this guide was tested
The Ryze AI connector was checked from outside on November 17, 2026, at about 15:40 UTC. No Zoho CRM organization is connected in the test workspaces, so the record below is short.
| What was checked | Result |
|---|---|
| The connector address with no sign-in (November 17, 2026) | https://connector.get-ryze.ai/mcp answered HTTP 401 with a WWW-Authenticate header that points to its sign-in details. Per Microsoft's docs, when a server needs OAuth the Copilot runtime asks VS Code to run the sign-in. |
| The two discovery files on the connector's host (November 17, 2026) | Both loaded. They name the authorize, token and register endpoints, the authorization code and refresh token grants, PKCE with S256, and two scopes: mcp:read and mcp:write. The register endpoint is what Dynamic Client Registration needs, and Microsoft's MCP developer guide names that method for VS Code. |
| The Zoho CRM tool list | Not seen live. The four tool names come from the Ryze AI 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 this page quotes no Zoho response, record or error message from a test. |
| Vendor pages | Microsoft's and GitHub's VS Code pages were read on November 14, 2026, and so were Zoho's docs and the Composio, Zapier, Windsor.ai and CData pages. |
Not run: any step inside VS Code. The ryze server was not added to Copilot Global, no trust prompt or sign-in was seen, and Copilot Chat sent no tool call. The VS Code steps follow Microsoft's documentation pages dated November 11, 2026 and GitHub's Copilot docs, both read on November 14, 2026. Zoho's VS Code install button and the Zoho MCP console were not set up; this guide describes them from Zoho's pages.
Errors and fixes
No Zoho CRM call was run for this guide. The Zoho error codes named below come from Zoho's API v8 pages, and none of them was seen in a test. The one VS Code message comes from Microsoft's documentation.
- The MCP server does not start in VS Code
- On Copilot Business or Enterprise, ask an administrator to enable the MCP servers in Copilot policy, which ships off. Admins can also block a server with deniedMcpServers or turn MCP off with chat.mcp.access set to none, and a local file cannot override either. Check the version too: MCP needs VS Code 1.99 or later and Copilot Global needs 1.140.
- The sign-in never opens
- Trust and sign-in are separate steps, so trust the server first. Then choose Authenticate from the ellipsis menu of ryze in MCP Servers, or run MCP: List Servers to see its state. Show Output in the same menu opens the log. Email Ryze AI support if it stays stuck.
- An older tutorial does nothing
- Tutorials built on .vscode/mcp.json target the Local harness. New sessions have used the Copilot harness since VS Code 1.143, which reads ~/.copilot/mcp-config.json and the workspace .mcp.json. Add the server again through Chat: Open Customizations.
- No Zoho CRM tools appear
- If Zoho CRM was connected in Ryze AI after the server was added, remove the ryze server, add it again and start a new chat so the tool list refreshes.
- A list call is rejected
- Zoho rejects list calls without field names. Its docs give REQUIRED_PARAM_MISSING (HTTP 400) for a missing fields parameter and LIMIT_EXCEEDED for more than 50 names. Ask Copilot 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. For record lists Zoho calls this DISCRETE_PAGINATION_LIMIT_EXCEEDED, and its page token expires after 24 hours with EXPIRED_VALUE. 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, and Zoho documents HTTP 207 for a batch where only some records went through. Ask Copilot to read back each record in the response and report the ones that carry an error.
- Copilot 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.
- Zoho answers NO_PERMISSION
- Zoho documents this HTTP 403 for a user whose role may not read the module. Connect a Zoho login that has that access, or ask a Zoho CRM administrator to widen the role.
- Calls fail with TOO_MANY_REQUESTS
- HTTP 429 means the organization's credits for the rolling 24 hours are spent or too many calls are running at once. Wait, or ask Copilot for fewer and smaller queries; a super admin can add credits in the API Dashboard.
- A write fails with DUPLICATE_DATA
- Zoho documents this HTTP 400 when a value you sent already sits in a unique field of another record. If you meant to change that record, ask Copilot to find it and update it instead of creating a new one.
- Cannot have more than 128 tools per request.
- VS Code allows 128 enabled tools in one chat request. Deselect tools or whole MCP servers in the tools picker of the Chat view until the count drops. A Zoho MCP console server with many tools can use up the budget alone.
- The tools reply that a subscription is required
- The Zoho CRM tools need an active Ryze AI plan or free trial. Start the trial in Ryze AI, then retry.
Terms on this page
- Agent Customizations editor
- The VS Code screen opened by Chat: Open Customizations. Its MCP Servers page adds, lists and manages servers.
- Copilot Global
- The personal MCP destination in VS Code, ~/.copilot/mcp-config.json, read in every workspace.
- COQL
- CRM Object Query Language: Zoho CRM's SQL-like SELECT, written with the API names of modules and fields and able to join modules through lookup fields.
- API name
- The name a module or field carries in API calls and COQL. Zoho CRM shows them under Setup > Developer Hub > APIs and SDKs > API Names.
- API credit
- How Zoho CRM meters API use: an allowance per edition over a rolling 24 hours, with most calls costing 1.
- Upsert
- One write that updates a record when a duplicate check field such as Email matches, and creates the record when nothing matches.
- Data center
- The Zoho region an account is registered in, such as US, EU, IN or AU. Each region holds only the data of the users registered there.
Sources: VS Code MCP servers, VS Code MCP configuration reference, Zoho CRM API v8 COQL overview, Zoho CRM API v8 limits, Zoho CRM API v8 get records. Checked November 14, 2026.
Frequently asked questions
How do I connect VS Code to Zoho CRM?
Connect Zoho CRM in Ryze AI under Integrations by signing in to Zoho and approving access, then run Chat: Open Customizations in VS Code, select MCP Servers and add an HTTP server with https://connector.get-ryze.ai/mcp. Trust it and sign in when VS Code asks.
Is there a Zoho CRM MCP server for VS Code?
Yes, several. The Ryze AI connector at https://connector.get-ryze.ai/mcp exposes 4 Zoho CRM tools and installs in VS Code through the MCP Servers page. Zoho offers four pre-built servers inside Zoho CRM with an Install MCP Server in VS Code button, and the Zoho MCP console, whose Connect section has an Add to VS Code button for servers you build there.
Which should I use, the Ryze AI connector or Zoho MCP?
Choose by the job. The Ryze AI connector brings Zoho CRM into VS Code next to other platforms on one connector URL, but on the Zoho side it covers Zoho CRM only and its write tool changes records only. Zoho MCP can mix tools from other Zoho apps and third-party services in one server, so it fits better when you need that, within VS Code's 128 enabled tools per chat request.
Do I need a Zoho API key?
No key appears in the Ryze AI steps for Zoho CRM. 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 Copilot Chat 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.
Can Copilot create custom fields or workflow rules in Zoho CRM?
Not through Ryze AI as documented: its write tool covers records, and no field, layout or workflow rule change is listed. Zoho's pre-built Module Customization and Workflow & Process Automation servers handle those, and each can be installed in VS Code from Zoho CRM.
Can I add Zoho CRM's built-in MCP servers to VS Code?
Yes. Zoho's docs have a VS Code setup page: in Zoho CRM open Setup > Developer Hub > MCP for AI Agents, pick a server, choose VS Code and click Install MCP Server in VS Code. Zoho announced the servers on April 6, 2026 as a phased rollout, and its docs do not say whether every data center has them yet. Zoho's manual steps use the older servers file format, which VS Code now labels deprecated.
Which GitHub Copilot plan do I need?
GitHub lists MCP on every Copilot plan. On Copilot Business and Enterprise an administrator must enable the MCP servers in Copilot policy, which ships off. VS Code 1.99 or later is required, and Copilot Global needs 1.140.
Does VS Code ask before changing a record?
Yes, unless you change it. A new session starts on Manual permissions, which show the tool name and inputs for a call that is not auto-approved. Allow all and Autopilot approve every call, and the top-level checkbox for ryze in Chat: Manage Tool Approval trusts every tool on the server, delete included.
Is Zoho CRM one of the GitHub Copilot connectors?
No. GitHub's list of Copilot connectors held 26 services on November 14, 2026, and Zoho CRM was not among them. For a service that is missing, VS Code's connector page says to add an MCP server by URL, which is what the Ryze AI steps above do.
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.
Does Copilot Chat use up my Zoho CRM API credits?
Yes, each tool call Copilot makes reaches Zoho's API and is counted against the organization's credits for a rolling 24 hours. A plain read costs 1 credit, a COQL query 1 to 3 depending on its LIMIT, and a write 1 for every 10 records.
How much does it cost to connect VS Code 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 VS Code?
Open Chat: Open Customizations, select MCP Servers and disable or uninstall the ryze server from its ellipsis menu. To withdraw the Zoho side as well, Zoho's OAuth documentation says a user can revoke a client's delegated access at any time.