By Ira Bodnar, Ryze AI · Updated · Facts checked November 14, 2026
Quick answer
The main way to connect Microsoft Copilot to Zoho CRM is the Ryze AI connector. Microsoft documents no Copilot chat window with a field for an MCP address, so the connector goes onto an agent: connect Zoho CRM in Ryze AI with a Zoho sign-in, then on a Copilot Studio agent add https://connector.get-ryze.ai/mcp as a Model Context Protocol tool with OAuth 2.0 and Dynamic discovery, and sign in to Ryze AI. The agent then holds 4 Zoho CRM tools: 2 that read, 1 that writes and 1 that deletes.
- 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 Copilot Studio switch to the classic experience, open your agent, then Tools, Add a tool, New tool, Model Context Protocol
- Enter a name, a description and the URL, pick OAuth 2.0 with Dynamic discovery, then select Create
- Create a new connection, sign in to Ryze AI, select Add to agent and ask the test chat for a COQL count of leads by lead source
Microsoft Copilot to Zoho CRM at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, a hosted MCP server that a Copilot Studio agent takes as a tool. A Microsoft 365 Copilot declarative agent can take it as an action, a route not yet confirmed for Ryze AI |
| Server address | https://connector.get-ryze.ai/mcp, the same for every user |
| Where it goes in Copilot | On an agent. Classic experience: Tools > Add a tool > New tool > Model Context Protocol. New experience: Build tab > Tools > Add > Model Context Protocol (MCP). Microsoft shows no chat window with a field for it |
| Sign-in | Copilot signs in to Ryze AI with OAuth 2.0 and Dynamic discovery. Zoho is joined once inside Ryze AI with a Zoho OAuth sign-in, and any Zoho data center works |
| Zoho CRM tools | 4: 2 read, 1 write and 1 delete |
| Can the agent change Zoho CRM | Yes, records only. zoho__write creates, updates or upserts up to 100 records per call and zoho__delete deletes records, which land in the Zoho CRM recycle bin for 60 days. Fields, modules and layouts are out of reach |
| Other data in the same chat | None from Zoho apps outside CRM. The Ryze AI connection covers Zoho CRM only. |
| Copilot plan | Microsoft names no plan for MCP. A trial cannot publish an agent, and the Copilot Studio for Teams plan has no Power Platform connectors or generative orchestration |
| Ryze AI price | $89 a month for Paid Ads after a 7-day free trial. Adding the connector costs nothing |
| Zoho own option | Four pre-built Zoho CRM MCP servers inside Zoho CRM, and the Zoho MCP console for building your own server. Zoho publishes setup pages for other clients and none for Copilot |
| Last checked | November 14, 2026, from Zoho and Microsoft pages. No Zoho CRM call was run through the connector and nothing was run inside a Microsoft product |
Before you start
- A Copilot Studio agent or a Microsoft 365 Copilot declarative agent. This is a builder task, usually done by an agent maker or admin in a work or school tenant. Microsoft says Copilot Studio is open to all Microsoft 365 users for creating agents and actions. A trial lets you build and test an agent but not publish it, and signing up for the trial takes a work or school account.
- A Copilot Studio plan that carries MCP. Microsoft says MCP access in Copilot Studio relies on Power Platform connectors. Its licensing page lists Power Platform connectors and generative orchestration as missing from the Copilot Studio for Teams plan. No Microsoft page says whether MCP tools run on that plan, so try it before you promise it to anyone.
- 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 scopes the connection asks for 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 the connector is free, and the Zoho CRM tools need an active plan or trial.
How to connect Copilot Studio to Zoho CRM
Step 1 happens in Ryze AI and Zoho, steps 2 to 6 in Copilot Studio. 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 and find the Zoho CRM card, which sits 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 Copilot, so the tool list is complete the first time.
Open the agent and start a new MCP tool
These steps are for the classic experience (the standard harness). New agents from the Copilot Studio home page run on the Microsoft Copilot harness, so switch first: select the three dots at the bottom of the home page side bar and choose Open classic experience, or start the agent from Other ways to build. Open your agent and go to its Tools page. Select Add a tool, then New tool, then Model Context Protocol under Create new. The MCP onboarding wizard opens.
Fill in the server details
Server name: Ryze AI. Server description: a plain note on what the tools do, for example Reads Zoho CRM records and runs COQL queries on modules such as Leads, Contacts and Deals, and creates, updates or deletes records. Microsoft says the agent orchestrator uses this description to decide when to call the server. Server URL: https://connector.get-ryze.ai/mcp.
Choose OAuth 2.0 with Dynamic discovery
Set the authentication type to OAuth 2.0 and the OAuth type to Dynamic discovery. The Ryze AI server supports dynamic client registration, so no client ID, secret or callback URL is typed. Of Microsoft's three OAuth types it calls Dynamic discovery the simplest. Select Create.
Create the connection and add the tool
On Add tool, select Create a new connection and complete the Ryze AI sign-in, or pick a connection you already made. Microsoft's page ends at that button and does not show the sign-in window, and this step was not run for this guide. Then select Add to agent.
Ask a Zoho CRM question in the test chat
MCP needs generative orchestration, which Microsoft says is on by default. Open the test chat panel and ask: Count the leads created this month, grouped by lead source. If the Zoho tools do not run, read the errors and fixes below.
The Ryze AI help article for Zoho CRM covers the Zoho side of the connection. Microsoft's page on connecting an agent to an existing MCP server covers the Copilot Studio wizard, and its page on switching experiences shows how to open the classic experience. Checked November 14, 2026.
Microsoft 365 Copilot declarative agent
People who work in Microsoft 365 Copilot and never open Copilot Studio can get the same URL through a declarative agent that carries it as an MCP action. Microsoft documents this in its Agents Toolkit walkthrough, and nothing in the Ryze AI facts confirms that the sign-in completes there.
- Install Visual Studio Code and Microsoft 365 Agents Toolkit version 6.12.0 or later.
- Select the Agents Toolkit icon in the Activity Bar, then Create a New Agent/App, then Declarative Agent.
- Select Add an Action, then Start with an MCP Server, and enter https://connector.get-ryze.ai/mcp.
- Choose OAuth (with dynamic registration) as the authentication type, then pick a project location and an agent name. No client ID, secret or scope is asked for. Microsoft says the authorization server must return a client secret at registration, and whether the Ryze AI server does so for Microsoft was not checked.
- In the Accounts pane sign in to Microsoft 365 and look for Custom App Upload Enabled and Copilot Access Enabled. If one is missing, an admin has to allow custom app upload.
- In the Lifecycle pane select Provision, read the dialog, select Confirm and wait for the toolkit to report that provisioning finished.
- Open m365.cloud.microsoft/chat, find the agent under Agents in the sidebar (its name ends in dev), ask a Zoho CRM question and select the Sign in button that carries the agent name.
Microsoft says Agents Toolkit sets a new MCP plugin to dynamic tool discovery, so Copilot reads the tool list from the server when it runs and you register no tools by hand. An admin must switch on Upload custom apps in the Teams admin center for sideloading. On first use Copilot asks the person to allow or cancel the plugin. Later, tools that only read run without a prompt and tools that change data ask again.
Sources: Build a plugin for a declarative agent from an MCP server, dynamic client registration for plugins, Microsoft 365 Copilot extensibility requirements, plugin overview. Checked November 14, 2026.
New experience, admin connector and personal Copilot
Microsoft documents more places for an MCP address than the two routes above. Each one changes who does the setup and how the sign-in works, so find out which your tenant uses before you start.
Copilot Studio, new experience
On the Microsoft Copilot harness you add the server from the agent's Build tab: Tools in the components panel, Add beside the search bar, then Model Context Protocol (MCP). The Add MCP server page asks for Name, Description, Server URL and Authentication. Select Add, review the tools Copilot Studio lists and Save. Microsoft marks that how-to page as preview, and its Authentication field names no choices, so the page does not say whether Dynamic discovery is one. For the Zoho CRM tools through Ryze AI, the classic steps above are the documented route.
Getting the agent to colleagues
Colleagues reach a Copilot Studio agent from Teams and Microsoft Copilot once it has been published at least once and linked to the Teams and Microsoft Copilot channels. A trial cannot publish, so a trial agent that holds the Zoho CRM tools stays in the test chat panel.
Admin route: a custom federated connector
A Global Administrator or AI Administrator can turn an MCP address into a connector in the Microsoft 365 admin center under Copilot > Connectors > Gallery > Create a new connector > Connect to MCP server. People with a Microsoft 365 Copilot license then turn it on in Copilot Chat under Settings > Sources. The sign-in methods Microsoft lists are Microsoft Entra SSO, OAuth 2.0 with a client registered by hand in the Teams Developer Portal, or No Auth. Dynamic registration is not among them, and the Ryze AI connector signs clients up through its register endpoint, so this route is unconfirmed for Ryze AI.
Copilot with a personal Microsoft account
Copilot on Copilot.com and Copilot Mobile with a personal account has four built-in connectors under Profile > Connectors: OneDrive, Outlook.com, Google Drive, and Gmail with Google Calendar and Contacts. Microsoft's support article mentions neither MCP nor a way to add a service of your own, and Zoho CRM is not listed, so a personal account has no documented place for Zoho CRM through Ryze AI.
Microsoft Copilot and MCP in one table
| Topic | What Microsoft's pages say |
|---|---|
| Where the address is typed | On an agent or in an admin connector. Copilot Studio: the MCP wizard (classic) or the Add MCP server page (new). Microsoft 365 Copilot: a declarative agent action, a custom federated connector or a plugin package manifest |
| Config files | None named for Copilot Studio, which is set up in the browser. Agents Toolkit writes ai-plugin.json into the agent project, and m365agents.yml holds isPKCEEnabled |
| Servers on your own computer | No route takes a start command. Microsoft 365 Copilot has to reach the server over the internet, and Microsoft points to a dev tunnel with a public HTTPS address for local work |
| Transport | Copilot Studio takes Streamable and dropped SSE after August 2025. Plugin packages and Cowork expect Streamable HTTP over HTTPS with TLS 1.2 or later |
| Sign-in, Copilot Studio wizard | None, an API key sent in a header or query parameter you name, or OAuth 2.0 as Dynamic discovery, Dynamic or Manual |
| Sign-in, declarative agent | Microsoft Entra SSO, dynamic client registration, the OAuth 2.0 authorization code flow or none. API keys are unsupported for MCP plugins, PKCE is on by default, and dynamic registration needs a client secret from the authorization server |
| Whose account a tool uses | A Copilot Studio tool uses End user credentials by default, so each person signs in, and Maker-provided credentials is the other choice. In the new experience connections are saved per agent and per channel |
| Confirmation before a tool runs | Copilot Studio switches on every tool of a new server (Allow all). Declarative agents ask on first use and then before tools that change data. Federated connectors run read tools freely and keep write and delete tools at Needs approval |
| Plan and billing | The MCP how-to pages name no plan. Agents on the new experience are billed in Copilot Credits that cover model tokens, the harness and tools, MCP servers included |
| Where servers are managed | Classic: select the server on the Tools page for Details, Tools, Resources and an Enabled toggle. New: the tools list on the Build tab. Declarative agents: Teams > Apps > Manage your apps |
| Admin controls | A data policy on Power Platform connectors also covers MCP servers. In the Microsoft 365 admin center, Agents > Tools > Registry can block a server, which turns off every tool it exposes |
Sources: adding an MCP server in the new experience, MCP in Copilot Studio, MCP tools and resources on an agent, agent tools and credentials, managing tools in the new experience, Teams and Microsoft Copilot channels, Copilot Credits, Copilot Studio access and browsers, plugin sign-in types, MCP servers in plugin packages, custom federated connectors, federated connector approvals, admin tool registry, Copilot connectors for personal accounts. Checked November 14, 2026.
Other AI clients
The same connector URL works in other MCP clients. Ryze AI has separate Zoho CRM guides for them:
Zoho CRM permissions
Two sign-ins are involved, and each one limits what the agent can reach.
- Zoho sign-in through Ryze AI
- A Zoho OAuth sign-in: you sign in to Zoho and approve access to CRM modules, settings, users and organization details. Any Zoho data center works, and the access renews on its own. Zoho says an access token lasts one hour and a refresh token lasts until the user revokes it.
- Whose permissions apply
- The scopes set a ceiling, and the Zoho CRM permissions of the user who connects still apply. Zoho documents a 403 NO_PERMISSION answer when that user cannot read a module, and says only admin users can fetch records from the Notes module. Choose who clicks Connect with that in mind.
- Ryze AI sign-in from Copilot
- The Copilot connection signs in to Ryze AI with OAuth 2.0. In Copilot Studio the tool runs on End user credentials unless the maker changes it, so each person who uses the agent makes a connection of their own. The agent reaches the Zoho CRM organization connected in the chosen Ryze AI workspace and nothing else.
- Power Platform data policy
- Microsoft notes that a data policy on Power Platform connectors also governs access to the MCP server and its tools. If a policy blocks the connector, ask your Power Platform admin.
Sources: Microsoft's MCP server and data policies note and the Ryze AI Zoho CRM integration. Checked November 14, 2026.
Zoho scopes the connection asks for
The Ryze AI 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.
| 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 |
Which OAuth scopes the Ryze AI connector hands a Copilot connection was not tested. The scopes above belong to the Zoho sign-in, which is the same whichever AI client calls the tools. Zoho's consent screen was not seen for this guide.
Which tool reaches what
The scopes decide what is possible, and the tool decides how the agent gets there. These rows show which tool each job needs.
| What you ask the agent to do | Tool it needs |
|---|---|
| Read a list of records, one record, module settings, fields or users | zoho__read |
| Run a COQL select with filters, joins through lookup fields and aggregates | zoho__query |
| Create, update or upsert records, up to 100 per call | zoho__write |
| Delete one record or several by ID | zoho__delete |
A workspace can hold several Zoho CRM organizations. One is the primary and is used unless you name another, and the tools accept an optional connection_id. A Zoho token belongs to one organization, so each organization is a separate connection.
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, COQL query scopes, Zoho OAuth overview, tokens and data centers, users API, organization API, Ryze AI Zoho CRM integration. Checked November 14, 2026.
Removing access
To take Zoho CRM away from a Copilot Studio agent, open its Tools page in the classic experience, hover over Ryze AI, select the three dots and Delete. To pause it instead, open the server, switch Enabled off and Save. In the new experience, select the X beside the server on the Build tab and then Remove. A sideloaded declarative agent is managed in Teams under Apps > Manage your apps. Zoho says users can revoke a client's delegated access at any time. The Ryze AI facts describe no disconnect step for Zoho CRM, so use Zoho's own connected-apps controls or ask Ryze AI support.
What Copilot 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 facts, which took them from app source. No workspace had Zoho CRM connected, so the tool list was not seen live. Copilot Studio adds the whole server as one tool and switches every tool on through Allow all. Turn Allow all off to switch single tools off.
| 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. |
Two of the four tools can change Zoho CRM, and whether Copilot stops to ask depends on where the agent runs. In the classic experience, the Allow all switch above is how you keep the agent away from zoho__write and zoho__delete. Microsoft describes a per-tool setting, Ask the end user before running, that defaults to No, but it does not say the setting appears for an MCP server, so look for it on the Ryze AI tool. The new-experience pages describe on and off switches only. A Microsoft 365 declarative agent asks on first use and then before tools that change data. The Ryze AI chat has its own Tool approvals setting that starts on Skip all approvals and can be set to Approve write & delete or Manual approve, and scheduled tasks in Ryze AI run without an approval step.
Limits in numbers
Three parties set limits on this route: the Zoho CRM API, the Ryze AI tools and Copilot. Zoho counts API use in credits per organization. Zoho's docs describe API v8, and the Ryze AI facts do not say which API version the tools call, so treat the Zoho figures as the documented ones and not as observed.
| Limit | Figure or rule | Set by |
|---|---|---|
| API credits per 24 hours | A rolling 24-hour window per organization. Free 5,000 credits. Standard or Starter 50,000 plus 250 per user license plus add-on credits, at most 100,000. Professional 50,000 plus 500 per license, at most 3,000,000. Enterprise or Zoho One 50,000 plus 1,000 per license, at most 5,000,000. Ultimate or CRM Plus 50,000 plus 2,000 per license, no maximum | Zoho |
| Credits per call | Most calls cost 1 credit. A COQL query costs 1 credit for LIMIT 1 to 200, 2 for 201 to 1,000 and 3 for 1,001 to 2,000. Insert, update or upsert costs 1 credit per 10 records. A mass delete by IDs costs 1 credit per 100 records. Record count in a module costs 50 | Zoho |
| Concurrent calls | Calls active at the same moment, per organization and app: Free 5, Standard or Starter 10, Professional 15, Enterprise or Zoho One 20, Ultimate or CRM Plus 25 | Zoho |
| Sub-concurrency | 10 in every edition for heavy calls, including the COQL query API, sorted or view-based record lists, and writes of more than 10 records. Going over returns TOO_MANY_REQUESTS | Zoho |
| Time-based limit | None per minute. Only credits and concurrency apply. After 50% of the daily credits are used, responses carry the header X-API-CREDITS-REMAINING. A super admin can buy more credits, billed monthly | Zoho |
| List page size | At most 200 records per request. The fields parameter is required for a list call and takes at most 50 field API names | Zoho |
| Paging past 2,000 records | The page parameter reaches the first 2,000 records. Beyond that a page_token is required, up to 100,000 records. A token belongs to one user and request and is valid for 24 hours | Zoho |
| COQL rows per query | LIMIT defaults to 200 and can be 2,000 at most. With LIMIT and OFFSET a query pages through up to 100,000 records for one set of criteria | Zoho |
| COQL query shape | Up to 500 field API names in SELECT, 25 criteria in WHERE, 10 fields in ORDER BY, 4 in GROUP BY and 100 values in an IN list. SELECT is the only statement. Joins through lookup fields are limited, and Zoho's limitations page states more than one join figure, so read it before building a wide join | Zoho |
| Write batch size | At most 100 records per insert, update or upsert call. When some records in a batch fail, Zoho documents HTTP 207 with a result for each record in input order | Zoho |
| Automation on writes | Zoho says that unless the trigger is switched off, workflows, approvals and blueprints tied to the module run on insert and upsert. Plan for a write to fire them | Zoho |
| Delete batch size and recycle bin | At most 100 records per delete call, and workflow rules run on deletion by default. Deleted records can be restored from the recycle bin for 60 days, then they are permanently deleted | Zoho |
| Search API | At most 2,000 records, 200 per page and 10 criteria. A record created a moment ago may not be found yet, and Zoho says to use COQL when you need no delay | Zoho |
| Rich text and subforms in lists | A list call cuts rich text fields to the first 500 characters. Subforms and multi-select lookups come back only when one record is fetched | Zoho |
| OAuth tokens | An access token is valid for one hour. A refresh token lasts until the user revokes it. Zoho keeps at most 20 refresh tokens per user | Zoho |
| Ryze AI tool caps | zoho__query returns up to 2,000 rows per call and zoho__write takes up to 100 records per call. Both match Zoho's own limits | Ryze AI |
| Tools on a Copilot Studio agent | Up to 128 with generative orchestration, and Microsoft suggests 25 to 30. The Ryze AI server is added as one tool, and Microsoft does not say whether the 4 Zoho tools inside it count toward 128 | Microsoft, classic experience |
| MCP servers in one conversation | An agent can hold several, but only a capped number run in one conversation and the rest are skipped for that turn. Microsoft gives no figure | Microsoft, new experience |
| Plugins in a declarative agent | Up to 5 plugins always enter the prompt, and answers may get worse above 10 tools in one plugin. The 4 Zoho tools stay below that | Microsoft 365 Copilot |
| Tool call time in plugin packages | A tool call should finish in under 30 seconds, which matters for a wide COQL query. Microsoft names this for plugin packages and Cowork | Microsoft |
Sources: Zoho CRM API limits, Get Records, COQL overview, COQL limitations, insert records, delete records, search records, OAuth token life, recycle bin, Copilot Studio tool limits, MCP servers per conversation, declarative agent plugin limits, Copilot Studio MCP troubleshooting, tool call time in plugin packages, Ryze AI Zoho CRM integration. Checked November 14, 2026.
First 3 prompts to run
Each answer comes from your own Zoho CRM organization, so this page says what comes back and shows no sample numbers. Add the prompts to the agent's instructions or paste them into the test chat.
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.
Ryze AI has not tested this connection in Copilot Studio or Microsoft 365 Copilot, and no Zoho CRM call was run through the connector for this guide. The prompts follow the tool descriptions in the Ryze AI facts and Zoho's COQL documentation, and the Copilot steps follow Microsoft's documentation and the connector's OAuth metadata, which supports dynamic client registration. Report anything that differs to Ryze AI support.
10 jobs to hand to a Copilot agent
Ten jobs a Copilot agent with the Ryze AI tool can take on, each matched to its tool. The last column says whether the default connection covers the job. None was run, from Copilot or from any other client.
| Job | Ask the agent | Tool | Works on the default connection |
|---|---|---|---|
| Lead count by source | Count the leads created this month by lead source. | zoho__query | Yes. COUNT and GROUP BY are documented COQL features. Not run |
| Open pipeline list | List open deals with amount, stage, owner and closing date, sorted by closing date. | zoho__query | Yes. Not run |
| Deals with account fields | Show deals together with fields of the linked account in one query. | zoho__query | Yes, through lookup-field joins, which Zoho limits per query. Not run |
| Totals by stage | Total the deal amount by stage or by lead source. | zoho__query | Yes. Zoho documents SUM, AVG, COUNT, MIN and MAX. Not run |
| Field names | List the fields of a module with their API names before writing a query. | zoho__read | Yes, with the settings scope. Not run |
| One full record | Read one lead, contact or deal in full by its ID. | zoho__read | Yes. Subforms and multi-select lookups come back on a single-record read only. Not run |
| Owner names | List the CRM users so owner IDs can be mapped to names. | zoho__read | Yes, with the users scope. Not run |
| Batch create | Create leads from a list I paste, up to 100 per call, then show the result for each record. | zoho__write | Yes. It changes the CRM, so check the per-record results. Not run |
| Upsert contacts | Upsert 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 |
| Delete named test records | Delete the test records I name. | zoho__delete | Yes. Deleted records go to the recycle bin for 60 days. Not run |
6 ways to connect Microsoft Copilot to Zoho CRM
Six ways can bring Zoho CRM into a Microsoft Copilot setup. This guide treats the Ryze AI connector as the main way: Copilot Studio's wizard takes its address with Dynamic discovery, Zoho is signed in once inside Ryze AI, and no key is pasted into Copilot. Zoho publishes two routes of its own and has no setup page for Copilot on either. None of the six was run inside Copilot for this guide.
| Way | Runs where | Setup in Copilot | What it reaches in Zoho CRM | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI at one address for every user | Copilot Studio: MCP wizard with the connector URL and OAuth 2.0 Dynamic discovery, then Create a new connection. Microsoft 365 Copilot: a declarative agent action, not confirmed for Ryze AI | 4 tools: 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 | Paid Ads $89 a month after a 7-day free trial; SEO Starter $129 a month; Agency $279 a month |
| Zoho CRM pre-built MCP servers | Hosted by Zoho, installed from inside Zoho CRM under Setup > Developer Hub > MCP for AI Agents | Zoho documents setup for Cursor, Claude Desktop, VS Code and Windsurf and says the servers work with any MCP client. No Copilot page exists, so the Copilot Studio fields were not checked | Four servers: Data Insights (read, COQL), Data Operations (create, read, update, delete and bulk operations), Module Customization (custom modules, fields and layouts) and Workflow and Process Automation (workflow rules). Zoho gives no tool counts | No price on the docs. MCP calls use API credits like any API call. Zoho said on April 6, 2026 that the rollout was in phases, and the docs do not say it is complete |
| Zoho MCP console | Hosted by Zoho. You build your own MCP server and copy its URL | Zoho documents steps for Claude, ChatGPT, Cursor, Windsurf and VS Code. Copilot is not named. The URL carries an API key that Zoho says to treat like a password, and the Copilot Studio fit was not checked | Whatever tools you add. Zoho's tool manual lists 1,319 tools for Zoho CRM in its catalog, with read, write and delete among them. Zoho advises at most 300 tools per server | $0 on Zoho's pricing page, with usage counted against your Zoho API quota. Zoho says it is free for now and that users will be told in advance of any pricing |
| Composio | Hosted by Composio at https://connect.composio.dev/mcp | Add the address and authorize Zoho through Composio's managed OAuth app. Composio names Claude, ChatGPT and Cursor, not Copilot, so the Copilot route was not checked | The Zoho toolkit lists 113 tools, read and write, covering COQL queries, search, notes, tags, attachments and workflow rule, custom field and layout tools | Free $0 with $2 in credits once, 3 members and app tool calls stopping at 10,000 a month. Standard $18 per seat per month |
| Zapier MCP | Hosted by Zapier | Add Zapier as a connector in the client, sign in and enable the Zoho CRM actions you want. Zapier names Claude, Claude Code, ChatGPT, Cursor, Codex, Gemini Enterprise, Grok, VS Code, Windsurf and Zed, and no Copilot product | The Zoho CRM actions you enable, such as add tag, convert lead, create or update module entries and an API request action in beta. The page prints no total, and the part of the list shown has no delete action | Each successful tool call uses 2 tasks from your Zapier plan. Free $0 with 100 tasks a month; Professional from $19.99 a month |
| Windsor.ai | Hosted by Windsor.ai; Zoho CRM is a data source | Choose Zoho CRM as a source in Windsor.ai. Its Zoho pages cover ChatGPT and Claude, and no Copilot setup for Zoho CRM was opened | Zoho CRM data for analysis: Leads, Deals, Contacts, Accounts, Tasks, Calls, Campaigns, Invoices and custom fields. The pages describe pulling and analyzing data and do not say records can be changed | Forever Free with 1 user, 1 data source and 1 account, limited to the past 30 days. Basic $23 a month, or $19 a month billed annually |
With a hosted third-party route your Zoho data passes through that vendor, and Microsoft says you are responsible for the tools and resources you reach through a non-Microsoft MCP server in Copilot Studio. Two Windsor.ai pages differ on the field count for Zoho CRM, so no count is given here.
Options that do not fit a Copilot agent
- 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 Copilot, 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, and Copilot Studio has no field for a start command, so it cannot be added to a Copilot agent without hosting it yourself.
- 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.
- A custom federated connector pointed at Ryze AI. This is the admin route in the section on other Copilot surfaces. None of its three sign-in methods is dynamic registration, which is how the Ryze AI connector signs clients up, so it stays unconfirmed.
Which one to pick
Pick the Ryze AI connector when one Copilot Studio agent should run COQL queries and edit Zoho CRM records and your team already works in Ryze AI. The caveats are that the route was not run inside Copilot, that it needs a Ryze AI plan once the trial ends, that it covers one organization per connection and that 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, which the Ryze AI write tool does not do, and can test the sign-in from Copilot Studio 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 Copilot route is untested.
Sources: Zoho CRM MCP servers, Zoho CRM MCP FAQ, Zoho CRM listing in Claude directory, Zoho MCP, Zoho MCP pricing, Zoho MCP implementation guide, Composio Zoho toolkit, Composio pricing, Zapier MCP for Zoho CRM, Zapier pricing, Windsor.ai Zoho CRM, Windsor.ai pricing, CData Zoho CRM MCP server, Pipedream Zoho CRM, Copilot Studio MCP guide, third-party MCP servers in Copilot Studio, custom federated connectors, Ryze AI Zoho CRM integration. Checked November 14, 2026.
Copilot, Zoho CRM and MCP: dates that matter
| Date | What happened |
|---|---|
| March 19, 2025 | Microsoft announced MCP support in Copilot Studio. The first release used the SSE transport. |
| May 29, 2025 | MCP in Copilot Studio reached general availability, with the tool list on the server settings page and the streamable transport. |
| July 17, 2025 | Zoho announced its own MCP server in a press release, with more than 15 Zoho tools in early access and general availability expected towards the end of 2025. |
| August 2025 | Copilot Studio stopped supporting SSE for MCP, leaving Streamable as the only transport. Microsoft gives no exact day. |
| December 15, 2025 | Microsoft announced general availability of MCP in declarative agents for Microsoft 365 Copilot, built in Agents Toolkit with Add Action and Start with an MCP server. |
| March 2026 | Zoho published its launch post for Zoho MCP on March 9, and the Zoho CRM listing in Claude's directory says Added March 2026 with no day. |
| April 6, 2026 | Zoho announced built-in MCP support in Zoho CRM in its community, rolling out in phases. |
| September 2, 2026 | A Microsoft Copilot blog post announced general availability of the GitHub Copilot harness in Copilot Studio, since renamed the Microsoft Copilot harness, with MCP servers as tools. Microsoft's how-to page for adding a server on that harness still carries a preview label. |
| October 2026 | A third-party tracker of the Zoho MCP changelog shows the latest Zoho CRM release adding 95 tools and removing 85, for the US, EU, IN, AU, JP, CA and SA data centers. |
| October 27, 2026 | The Microsoft 365 Copilot release notes list admins creating custom MCP connectors in the Microsoft 365 admin center under this date. Microsoft's roadmap item gives an earlier month, February 2026. |
| November 14, 2026 | Zoho's tool manual lists 1,319 tools for Zoho CRM, the Claude listing shows 41, Zoho's CRM docs list four pre-built servers and Zoho's MCP pricing page says $0. |
Sources: Microsoft Copilot blog, March 19, 2025, Microsoft Copilot blog, May 29, 2025, SSE support ended after August 2025, Microsoft 365 Developer Blog, December 15, 2025, Microsoft Copilot blog, September 2, 2026, adding an MCP server in the new experience, Microsoft 365 Copilot release notes, Microsoft 365 roadmap item 501585, Zoho press release, July 17, 2025, Zoho MCP launch post, March 2026, Zoho CRM listing in Claude directory, Zoho community post, April 6, 2026, Zoho MCP changelog (third-party tracker), Zoho CRM MCP servers overview, Zoho MCP pricing. Checked November 14, 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 the Ryze AI facts and were not seen in a live tool list. Everything below was read from vendor pages on November 14, 2026.
| What was run | What came back |
|---|---|
| The four Zoho CRM tool names | Taken from the Ryze AI facts file. 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. |
| Claude connector listing, Composio, Zapier, Windsor.ai and CData pages | Read for the comparison. Their tool counts and prices are as the pages printed them. |
| Microsoft's Copilot Studio and Microsoft 365 Copilot pages | Read for every setup step, limit, plan note and date used here. |
Not run for this guide: any Zoho CRM call and anything inside a Microsoft product. No Copilot Studio agent was created, no MCP tool was added, no Agents Toolkit project was built, no admin center connector was set up and no Ryze AI sign-in happened from Copilot. The Zoho consent screen was not seen. The Copilot steps follow Microsoft's and Ryze AI's documentation as read on November 14, 2026.
Errors and fixes
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, with Zoho's own wording. The Microsoft and Ryze AI entries come from Microsoft's documentation or the Ryze AI facts and say so.
- REQUIRED_PARAM_MISSING (HTTP 400): One of the expected parameters is missing.
- Zoho documents this for a list call without the fields parameter. Name the fields to return, at most 50 API names, or use a COQL query instead.
- LIMIT_EXCEEDED (HTTP 400): Fields limit exceeded.
- Zoho documents this for more than 50 field API names in the fields parameter. Ask for 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 paging past 2,000 records with the page parameter. Use the page token that Zoho returns, which is valid for 24 hours, or narrow the criteria.
- EXPIRED_VALUE (HTTP 400): The token given has expired.
- Zoho documents this for a page token older than 24 hours. Start the list again.
- NO_PERMISSION (HTTP 403): Permission denied to read records
- Zoho documents this when the connected user cannot read that module. Ask a Zoho admin to change the profile of the user who connected, or connect with a user who can.
- TOO_MANY_REQUESTS (HTTP 429)
- Zoho documents this when the 24-hour credit allowance is used up or too many calls run at once. Wait, ask for fewer calls at a time, or have a super admin buy credits.
- DUPLICATE_DATA (HTTP 400): duplicate data
- Zoho documents this when a write gives a value that already exists in a unique field. Use an upsert, 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 more than 2,000 records. Narrow the search or use a COQL query.
- A write answers 200 but a record failed
- Per the Ryze AI facts, a 200 write response can still hold per-record errors, and Zoho documents HTTP 207 with a result per record for partial success. Check every record in the answer.
- There is no place to paste the URL in Copilot chat
- Microsoft's pages show no field for an MCP address in a Copilot chat window. Add the URL as a tool on a Copilot Studio agent or build a declarative agent in Agents Toolkit. An admin can also create a custom federated connector, but that route was not confirmed for Ryze AI.
- The Tools page or the New tool button is missing
- The agent runs on the new experience, where tools sit on the Build tab. Open the classic experience from the three dots at the bottom of the home page side bar, or create the agent with Other ways to build.
- I cannot publish the agent
- A Copilot Studio trial lets you create and test agents but not publish them. Use the test chat panel, or move to a plan that can publish.
- Model Context Protocol or connectors are missing on the Teams plan
- The Copilot Studio for Teams plan has no Power Platform connectors or generative orchestration, and MCP access relies on connectors. Ask your admin about a standalone Copilot Studio subscription.
- The connector is blocked
- A Power Platform data policy that regulates connectors also regulates the MCP server, and a blocked tool shows as disabled in the Add tool panel. Ask your Power Platform admin to allow it.
- Agents Toolkit says Custom App Upload is not enabled
- Sideloading needs Upload custom apps switched on by an admin in the Teams admin center. Ask your admin, then reload the Accounts pane.
- The declarative agent sign-in fails
- Microsoft's dynamic registration for declarative agents needs the authorization server to issue a client secret, and registration without one is not supported yet. That was not checked for the Ryze AI server, so use the Copilot Studio route if the sign-in does not finish.
- The agent never calls the Zoho tools
- Microsoft says the orchestrator uses the server description to decide whether to call the server. Rewrite the description to say what the tools do, such as running COQL queries on Zoho CRM modules, and check that generative orchestration is on.
- The tools return a subscription message or no data
- The Zoho CRM tools need an active Ryze AI plan or free trial, and Zoho CRM must show as Connected under Integrations in Ryze AI. If the connector was added before Zoho was connected, remove it from the agent, add it again and start a new test chat.
- I need a second Zoho CRM organization
- In Ryze AI, click View on the Zoho CRM card and choose Add one more account. The primary organization is used unless the prompt names another.
Sources: Zoho CRM status codes, Get Records errors, upsert errors, Search Records errors, Zoho scopes, Copilot Studio MCP troubleshooting. Checked November 14, 2026.
Terms on this page
- MCP (Model Context Protocol)
- An open standard through which an AI model reaches outside data and applications. Copilot Studio adds an MCP server to an agent as a tool, and Zoho runs MCP servers of its own.
- Dynamic discovery
- A Copilot Studio OAuth 2.0 option for servers that support dynamic client registration. Copilot Studio finds the sign-in endpoints and registers itself, so nobody types a client ID.
- Declarative agent
- A Microsoft 365 Copilot agent built from a manifest, here in Agents Toolkit, that can carry an MCP server as an action.
- 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.
Sources: COQL, Copilot Studio experiences, Dynamic discovery, declarative agents with MCP, Zoho scopes, upsert and duplicate check fields, recycle bin, Zoho MCP help, data centers, COQL and API names, page tokens. Checked November 14, 2026.
Frequently asked questions
How to connect Copilot to Zoho CRM?
Ryze AI is the best way to connect Microsoft Copilot to Zoho CRM for an agent that should run COQL queries and edit records, though it has not been run inside Copilot and needs a Ryze AI plan or trial. Connect Zoho CRM in Ryze AI, then add https://connector.get-ryze.ai/mcp as a Model Context Protocol tool on your Copilot Studio agent with OAuth 2.0 and Dynamic discovery, select Create and create the connection.
Is there a Zoho CRM connector for Copilot?
Zoho has no documented Copilot setup page. Zoho publishes setup pages for Cursor, Claude Desktop, VS Code and Windsurf, and a listing in Claude's directory. For a Copilot Studio agent, the Ryze AI connector is a hosted server you add as an MCP tool, and the route has not been run inside Copilot.
Is there a Copilot Zoho CRM MCP server I can use?
Yes, hosted ones can be tried. The Ryze AI connector at https://connector.get-ryze.ai/mcp gives an agent 4 Zoho CRM tools. Zoho's own pre-built servers sit under Setup > Developer Hub > MCP for AI Agents in Zoho CRM, and its MCP console builds a custom server. Neither Zoho route names Copilot, and none of these was run inside Copilot for this guide.
Can I paste an MCP URL into the Copilot chat app?
No. None of Microsoft's pages shows a Copilot chat window that takes an MCP address. The URL goes in Copilot Studio on an agent's Tools page or Build tab, in a declarative agent built with Microsoft 365 Agents Toolkit, or in an admin's custom federated connector that people then turn on under Settings > Sources.
Which Copilot plan do I need?
Microsoft says Copilot Studio is open to all Microsoft 365 users for creating agents and actions. A trial can create and test but not publish. The Teams plan has no Power Platform connectors, which MCP access relies on, so plan for a standalone Copilot Studio subscription. Microsoft 365 Copilot declarative agents need an admin to allow custom app upload.
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 Zoho CRM permissions of the connecting user still apply on top of those scopes.
Can Copilot change my Zoho CRM data or delete things?
Through Ryze AI, yes, for records. zoho__write creates, updates or upserts up to 100 records per call and zoho__delete deletes records, which go to the Zoho CRM recycle bin for 60 days before they are permanently deleted. In Copilot Studio, switch Allow all off to keep the agent away from the write and delete tools.
Can Copilot create fields or edit workflow rules in Zoho CRM?
Not through the Ryze AI connector. Its 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 Copilot.
Does the Ryze AI connector work with Copilot Studio?
The connector is a remote MCP server with OAuth that supports dynamic client registration, which matches Microsoft's Dynamic discovery option. Ryze AI has not tested it in Copilot Studio or Microsoft 365 Copilot, so try it on an organization where a mistake is cheap to undo.
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. How a Copilot connection picks a workspace was not tested.
How many records can the agent read 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. Zoho counts COQL calls in credits: 1 for up to 200 rows, 2 for up to 1,000 and 3 for up to 2,000.
Which transport does Copilot Studio support?
Microsoft says Copilot Studio supports the Streamable transport for MCP and no longer supports SSE after August 2025.
How much does it cost?
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. Copilot Studio licensing is set by Microsoft, and Zoho API credits depend on your Zoho edition.
How do I disconnect Zoho CRM from Copilot?
Remove the Ryze AI tool from the agent in Copilot Studio. Zoho says users can revoke a client's delegated access at any time. The Ryze AI facts describe no disconnect step for Zoho CRM, so ask Ryze AI support if you need the connection removed on the Ryze AI side.