By Ira Bodnar, Ryze AI · Updated · Test record November 14, 2026
Quick answer
The main way to connect Windsurf to Zoho CRM is the Ryze AI connector. Approve Zoho CRM once inside Ryze AI with Zoho's own sign-in, then put "ryze": {"url": "https://connector.get-ryze.ai/mcp"} under mcpServers in ~/.config/devin/mcp_config.json. Sign in with the Authenticate button in Devin Desktop, or with devin mcp login ryze in the Devin CLI, click Allow connection, and the agent has 4 Zoho CRM tools: two to read, one to write and one to delete.
- In Ryze AI open Integrations, click Connect on the Zoho CRM card and sign in to Zoho
- Approve access to CRM modules, settings, users and organization details
- In Windsurf open Customize, then MCPs, and add the ryze server with the connector URL
- Click Authenticate, then Allow connection, and ask for the fields of your Leads module
Windsurf to Zoho CRM at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, kept in Devin's mcp_config.json as one url entry named ryze, or added with devin mcp add in the Devin CLI |
| Server address | https://connector.get-ryze.ai/mcp. The same address serves every platform connected in the Ryze AI workspace |
| Windsurf in November 2026 | Shipped as Devin Desktop since June 2, 2026. Devin Local is the agent that calls MCP tools; Cascade was removed on September 8, 2026 |
| Sign-in | Zoho is approved once inside Ryze AI on Zoho's own screen, on any Zoho data center, and access renews by itself. Windsurf then signs in to Ryze AI through browser OAuth and registers itself, so no client ID is pasted |
| Zoho CRM tools | 4 in total: 2 read (zoho__read, zoho__query), 1 write (zoho__write) and 1 delete (zoho__delete) |
| Can it change Zoho CRM | Yes, records. The write tool creates, updates and upserts up to 100 records per call, and the delete tool sends records to the Zoho CRM recycle bin. Devin Local asks before each MCP tool call by default |
| Other data in the same chat | The connector address is shared, so other connected platforms appear next to the Zoho CRM tools. This guide covers the 4 Zoho CRM tools only |
| Windsurf plan needed | Cognition's MCP pages name none and the Devin pricing page has no MCP row. The admin MCP settings carry the label Teams & Enterprise |
| Ryze AI price | Paid Ads at $89 per month after a 7-day free trial. Adding the connector costs nothing |
| Zoho's own option for Windsurf | Four pre-built servers inside Zoho CRM, and the Zoho MCP console. Zoho has a Windsurf setup page for each, written around the older Windsurf config file |
| Last checked | Windsurf and Zoho pages on November 14, 2026. No Zoho CRM call and no step inside Windsurf was run |
Windsurf was renamed Devin Desktop on June 2, 2026; Cognition's changelog, its rename post and its FAQ all give that date. The MCP documentation moved to Devin's site: docs.windsurf.com/windsurf/cascade/mcp redirects to docs.devin.ai, and windsurf.com redirects to devin.ai/desktop, titled Devin Desktop. This guide keeps the name Windsurf because that is what people search for, and takes menu names and file paths from the current Devin docs. Cascade conversations can no longer be started, so an older step that opens a Cascade MCP panel is out of date. If your install looks different, check which Customize page it shows.
Before you start
- Windsurf (Devin Desktop) on Mac, Windows or Linux. Cognition's MCP documentation names no plan for adding a server. The Devin Local page says Enterprise admins manage MCP registries under MCP & ACP in team settings, and the admin reference lists the MCP allowlist under Teams & Enterprise, so on a team account an admin may need to approve the Ryze AI server first.
- A Zoho login 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, and the CRM role of the login still limits what the agent can read.
- 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 Windsurf to Zoho CRM
Two steps happen in Ryze AI and Zoho CRM, three in Windsurf, and the last is your first prompt. 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.
Open the MCP settings in Windsurf
From the Agents window open the Customize page and click MCPs. Use Install MCPs for to pick the scope, for example This computer.
Add the Ryze AI server
Open the config file and add the server under mcpServers: "ryze": {"url": "https://connector.get-ryze.ai/mcp"}. The user file is ~/.config/devin/mcp_config.json and the project file is .devin/mcp_config.json.
Sign in to the connector
Refresh the list under This computer. When the ryze server wants authorization it offers an Authenticate button: click it, finish the Ryze AI sign-in in your browser and click Allow connection. In the Devin CLI the matching command is devin mcp login ryze.
Ask your first question
Start a new session and ask: List the fields of my Leads module in Zoho CRM, with each API name and type. Approve the tool call when Windsurf asks.
The Ryze AI Zoho CRM guide covers the Zoho side of the connection, and the Ryze AI help article on API keys and the MCP endpoint covers the connector URL.
Sources: Devin Desktop: MCP and customizations, Devin CLI: MCP configuration, Devin Desktop changelog, Ryze AI Zoho CRM guide. Checked November 14, 2026.
Config file, Devin CLI and imports
Windsurf now runs on Devin, so the same server can be added in the editor settings, in a config file or from the Devin CLI. Pick the route that matches how you work.
Devin Desktop (Windsurf) config file
{
"mcpServers": {
"ryze": {
"url": "https://connector.get-ryze.ai/mcp"
}
}
}Use ~/.config/devin/mcp_config.json (%APPDATA%\devin\mcp_config.json on Windows) when you want Ryze AI in every project, or .devin/mcp_config.json to keep it with one repository. The project file travels with the repository, so everyone who clones it sees the entry; Devin also reads a gitignored .devin/mcp_config.local.json for an entry meant for you alone. Devin Local supports stdio, Streamable HTTP and SSE with OAuth for each, trying Streamable HTTP first and falling back to SSE on 4xx errors that are not about sign-in.
Devin CLI
devin mcp add -s user ryze https://connector.get-ryze.ai/mcp
devin mcp login ryzeThe first command writes the server to your user config. The second opens the Ryze AI sign-in, where you click Allow connection. Use them when you would rather not edit JSON by hand. Without -s user the entry goes to the gitignored local file of the folder you are in. Cognition's pages do not say that a sign-in made in the CLI is reused inside Devin Desktop, so use Authenticate there.
Servers kept in an old Windsurf file
Zoho's own Windsurf setup pages tell you to open ~/.codeium/windsurf/mcp_config.json from the Windsurf: MCP Registry command and add an entry with a serverUrl key. Cognition's import page says the Devin CLI still reads MCP servers from the old Windsurf file ~/.codeium/<channel>/mcp_config.json, but that page is written for the CLI. For Devin Desktop the FAQ says only that Windsurf settings carry over to Devin Local, so check the This computer list before adding anything twice. Whether serverUrl still works was not verified; the current Devin reference lists url, so this guide uses url.
Sign-in and limits
OAuth uses dynamic client registration by default, so there is no client ID or secret to enter for the Ryze AI connector. Each MCP client keeps its own OAuth session, so a Ryze AI sign-in made in another tool does not carry over to Windsurf. The Devin Local page describes the Needs authentication state for expired credentials only. For a first sign-in, the July 29, 2026 release note added an Authenticate button for servers that need authorization, and the Devin CLI page says an OAuth server asks for a sign-in the first time it is used. Since November 8, 2026 the "..." menu in a session header can also re-authenticate a server.
Windsurf and MCP: the facts in one table
| Topic | What Cognition's documentation says |
|---|---|
| Where you add a server | The MCPs tab of the Customize page in the Agents window, with Install MCPs for set to a scope such as This computer. Its Available list installs servers from MCP registries |
| Config files | User: ~/.config/devin/mcp_config.json. Project: .devin/mcp_config.json. Private override in a project: .devin/mcp_config.local.json, ignored by git |
| A remote entry | url is the one required field. transport, headers, oauthClientId, oauthClientSecret, oauthResource, oauthScopes, disabled and disabledTools are optional |
| Transports | stdio, Streamable HTTP and SSE. A url goes over Streamable HTTP first; SSE is tried on the same address only after a 4xx that is not about sign-in |
| Sign-in | OAuth with dynamic client registration. A 401 carrying a WWW-Authenticate challenge counts as a request to sign in |
| Static keys | A token for a remote server goes in headers. ${env:VAR} and ${file:/path} keep the secret itself out of the file |
| Tool names | mcp__<server>__<tool>. By that pattern the COQL tool would be mcp__ryze__zoho__query; this guide did not see the name in Windsurf |
| Approval | Devin Local asks before every MCP tool call. A grant covers one tool or the whole server, for the session or for good |
| Rules and modes | Allow, Deny and Ask rules in Devin Local settings take patterns such as mcp__ryze__*, and deny wins. Bypass Permissions mode skips the prompts unless the organization requires approval |
| Where servers are managed | The This computer list (switch on or off, open the config file, refresh) and, since November 8, 2026, the "..." menu of a session header |
| Admin controls | Allow MCP, MCP allowlist, MCP registry and MCP registry URLs, labeled Teams & Enterprise. One allowlisted server shuts out every other one |
| Plan | Plans are Free, Pro, Max, Teams and Enterprise. None is named for adding an MCP server |
| Limits on servers | No page opened on November 14, 2026 gives a cap on the number of MCP servers or tools in Devin Local |
Sources: Devin Desktop: MCP and customizations, Devin CLI: MCP configuration, Devin CLI: MCP overview, Devin CLI: config file, Devin CLI: read config from other tools, Devin Local permissions, Devin Local modes, Devin Desktop admin controls, Devin Desktop FAQ. Checked November 14, 2026.
Other clients
The same URL works in other MCP clients. Zoho CRM is approved once in Ryze AI, so nothing changes on the Zoho side.
Claude Code
Run claude mcp add --transport http ryze https://connector.get-ryze.ai/mcp --scope user, then /mcp inside Claude Code to sign in.
Claude on the web and Desktop
Open Customize, Connectors, click + Add, choose Add custom connector, name it Ryze AI and enter the URL. In Claude you can set write and delete tools to Needs approval under Customize > Connectors > Ryze AI > Tool permissions.
ChatGPT
Add the same URL as an app under Settings > Apps, pick the workspaces and start a new chat. If the connector was added before Zoho CRM was connected in Ryze AI, remove and re-add it so the tool list refreshes.
Cursor
Add the server to ~/.cursor/mcp.json or .cursor/mcp.json.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Zoho CRM access and Windsurf settings
Two sign-ins are involved: Zoho for CRM access and Ryze AI for the connector. Three things decide what the Windsurf agent can reach.
- Which organization
- The Zoho CRM organization you signed in to. You can connect several Zoho CRM organizations to one workspace (View > Add one more account). One is the primary and is used unless you name another, and the tools accept an optional connection_id.
- What the agent can change
- The tool set has write and delete tools, so the agent can create, update, upsert and delete records when you ask. Deleted records go to the Zoho CRM recycle bin. Ryze AI documents no changes to CRM settings or module configuration, so treat the connection as record-level access.
- What Windsurf asks first
- Devin Local asks before each MCP tool call by default, so a record update waits for your click until you grant the tool or the whole server.
The Zoho scopes of the default connection
Windsurf itself holds only a Ryze AI sign-in. The Zoho access stays with the connection you approved in Ryze AI, which asks for the five OAuth scopes below. 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 how the Ryze AI tools use each scope.
| OAuth scope | What Zoho says it covers | Use 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 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, and the Zoho CRM role of the login you connect still applies below it: Zoho returns NO_PERMISSION (HTTP 403) when that user may not read a module.
Sources: Zoho CRM API v8: scopes, Zoho CRM API v8: get records, Zoho CRM API v8: COQL overview, Ryze AI Zoho CRM guide. Checked November 14, 2026.
Removing access
Inside Windsurf you have four options: turn the ryze toggle off under Customize > MCPs, add "disabled": true to the entry so its tools disappear, delete the entry from mcp_config.json, or run devin mcp remove ryze. Running devin mcp logout ryze forgets the saved sign-in and keeps the server. 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 Windsurf can do in Zoho CRM
The Ryze AI connector exposes 4 Zoho CRM tools: 2 read, 1 write and 1 delete. Writes and deletes are separate tools, so you can approve them separately. By Cognition's naming pattern, Devin shows each one as mcp__ryze__ followed by the name below. 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.
| 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. |
Approvals in Windsurf
Devin Desktop asks before calling any MCP tool by default, so a query and an update both prompt until you change that. Loosening it for the ryze server also removes the prompt in front of the write and delete tools, so allow only what you need. Scheduled tasks in Ryze AI run without an approval step, and the Ryze AI chat has its own Tool approvals setting that starts on Skip all approvals; Approve write & delete and Manual approve are the stricter choices.
To keep the delete tool out of reach, add a Deny rule for mcp__ryze__zoho__delete in Devin Local settings, or list zoho__delete under disabledTools in the ryze entry. Both follow Cognition's documentation and were not tried in Windsurf.
Limits in numbers
Zoho's API decides how much one call from Windsurf 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.
| Limit | What Zoho documents |
|---|---|
| Rows from one COQL query | 200 when LIMIT is left out, 2,000 at most. LIMIT with OFFSET pages through up to 100,000 records for one set of criteria |
| Size of one COQL query | 500 fields in SELECT, 25 conditions in WHERE, 10 fields in ORDER BY, 4 in GROUP BY, 5 aggregate fields and 100 values inside IN or NOT IN. SELECT is the only statement, and multi-line fields such as Description cannot be filtered on |
| Records per list page | 200, which is both the default and the ceiling for per_page |
| Field names in a list call | Required when fetching all records, 50 at most |
| Paging | The page parameter reaches record 2,000. From there a page token is needed, up to record 100,000. A token is tied to one user and one set of parameters and lasts 24 hours |
| Records per write | 100 per insert, update or upsert call, with a duplicate check on unique fields at every insert. A batch with mixed results answers HTTP 207 Multi-Status, one result per record |
| Automation on writes | Workflows, approvals and blueprints tied to the module run on insert and upsert unless the trigger key is sent as an empty list |
| Records per delete | 100 per call. Workflow rules fire on delete by default, and subforms are deleted with their record |
| Recycle bin | 60 days to restore a deleted record, after which Zoho removes it permanently |
| Search | 2,000 records at most, 200 per page, 10 criteria. A record saved a moment ago may be missing while Zoho indexes it; Zoho points to COQL when there must be no delay |
| 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 |
| Zoho access token | 1 hour, renewed with a refresh token that lasts until the user revokes it |
| Credits per rolling 24 hours | Counted per organization. Free 5,000. Standard/Starter 50,000 + 250 per user license, capped at 100,000. Professional 50,000 + 500 per license, capped at 3,000,000. Enterprise/Zoho One 50,000 + 1,000 per license, capped at 5,000,000. Ultimate/CRM Plus 50,000 + 2,000 per license, with no cap |
| Credits per call | Usually 1. COQL costs 1 up to LIMIT 200, 2 up to 1,000 and 3 up to 2,000. Writes cost 1 per 10 records and mass deletes 1 per 100 |
| Running out | HTTP 429 with TOO_MANY_REQUESTS. A super admin can raise the limit in the API Dashboard, billed monthly for the credits actually used |
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 the agent to check each record in the result. The tools work only while the Ryze AI workspace has an active plan or free trial.
Sources: 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: upsert records, Zoho CRM API v8: delete records, Zoho CRM API v8: search records, Zoho CRM API v8: token validity, Zoho CRM: recycle bin. Checked November 14, 2026.
First 3 prompts to run
Answers come from your own organization, so each prompt says what comes back and shows no sample numbers. Replace module and field names with ones from your own CRM.
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 in the Windsurf session. 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, once you approve the tool call in Windsurf. A 200 response can still hold per-record errors, so the prompt asks the agent to check each one.
None of these prompts was run, because no Zoho CRM organization was connected for testing, so this page shows no result for any of them. Keep Windsurf's approval prompt on for the ryze server while you try the third one, since it changes records.
10 jobs to hand to the Windsurf agent
Ten jobs to give the Devin Local agent, each with the Zoho CRM tool it would use. None was run for this guide. The last column says whether the five scopes of the default connection cover the job, going by Zoho's documentation. A job that changes something waits for your click in Windsurf unless you allowed the tool.
| Job | Ask the agent | Tool | Works 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 |
| 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, after you approve the call in Windsurf |
| Sync contacts | Upsert these contacts on Email, so existing ones update and new ones are created. | zoho__write | Yes, after you approve the call. Zoho matches Contacts on Email by default |
| Clear test leads | Delete the test leads I list here by ID. | zoho__delete | Yes, after you approve the call. Zoho keeps them in the recycle bin for 60 days |
| New picklist field | Add a Region picklist to the Leads module. | None | No. The Ryze AI write tool covers records; Zoho's Module Customization server handles fields |
5 ways to connect Windsurf to Zoho CRM
Five ways can put a Zoho CRM organization in Windsurf. This guide uses the first, the Ryze AI connector, as the main way: one Zoho approval in Ryze AI, one url entry in Devin's config, and separate tools for reading, writing and deleting. Of the other four, Zoho names Windsurf on its own setup pages and Zapier lists it among its clients, while Composio's pages name other clients. For the rest the setup cell describes the route as the vendor wrote it. None of the five was run in Windsurf.
| Way | Runs where | Setup in Windsurf | What it reaches in Zoho CRM | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI. One address, also used by Claude and ChatGPT | A url entry in mcp_config.json, or devin mcp add, then Authenticate. 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 the servers live under Setup > Developer Hub > MCP for AI Agents. Zoho's Windsurf page opens the Windsurf: MCP Registry command, then ~/.codeium/windsurf/mcp_config.json, and adds an entry with a serverUrl key. A pop-up asks you to open an authentication URL. That layout predates Devin Desktop, so the file and key may differ in your install | 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 and copy its MCP URL. Zoho's Windsurf route is Settings, search for mcp, Manage Plugins, View Raw Config, then an mcp-remote JSON entry with the URL. The URL carries an API key, so Zoho says to treat it like a password | The tools you pick: Zoho's Tool Manual lists 1,319 for Zoho CRM among 76 services. With Authorization on Demand each user signs in with their own Zoho account, and agents can do only what that user may do | $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 Windsurf among its other clients and says clients without their own setup page use a connection token. Then 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 | Composio's pages name Claude, ChatGPT and Cursor, and give setup steps for Claude and Claude Code, so no Windsurf steps are shown here. 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 |
Four Zoho CRM options that do not fit this job
- 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 names Claude only, so it carries no Windsurf setup.
- 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. Devin Local supports stdio servers, but this guide did not try this one.
- 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 Windsurf to Zoho CRM for COQL reporting and record edits across several Zoho CRM organizations, from one address that Claude and ChatGPT 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 fit when an admin reshapes the CRM, through Module Customization and Workflow & Process Automation, but Zoho's Windsurf steps use the older config file, so check them against Devin's current layout first. The Zoho MCP console suits one server that mixes Zoho CRM with other Zoho apps or third-party tools. Zapier and Composio fit teams that already run them for other apps. Devin reads several named servers from one config file, so a Zoho server and the ryze entry can sit side by side.
Sources: Zoho CRM MCP: overview, Zoho CRM MCP: Windsurf setup, Zoho CRM MCP: FAQs, Zoho MCP: pricing, Zoho MCP: implementation guide, Zoho MCP: FAQ, Claude directory: Zoho CRM, Zapier MCP for Zoho CRM, Zapier MCP quickstart, Composio Zoho toolkit, Composio pricing, Windsor.ai: Zoho CRM, CData zoho-crm-mcp-server, Devin CLI: MCP configuration. Checked November 14, 2026.
Windsurf, Zoho CRM and MCP: dates that matter
| Date | What happened |
|---|---|
| February 13, 2025 | Windsurf Wave 3 brought MCP servers to Cascade, on individual plans first (Cognition launch post). |
| July 17, 2025 | Windsurf 1.11.0 added the Streamable HTTP transport and MCP authentication in place of access tokens or API keys in the config. The same day, a Zoho press release announced Zoho's own MCP server in early access. |
| 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, 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. |
| June 2, 2026 | Windsurf became Devin Desktop (v3.0.12). |
| July 29, 2026 | Devin Desktop 3.6.22 gave servers that need authorization an Authenticate button. |
| September 8, 2026 | Devin Desktop 3.9.19 removed Cascade, leaving Devin Local as the only built-in agent. |
| 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. |
| November 8, 2026 | Devin Desktop 3.12.32 put each session's MCP servers in the "..." menu of the session header. |
Sources: Devin Desktop changelog, Cognition: Windsurf Wave 3, Cognition: Windsurf is now Devin Desktop, Zoho: MCP launch post, Zoho community: built-in MCP support, Claude directory: Zoho CRM, Zoho MCP changelog. Checked November 14, 2026.
How this guide was tested
No call to Zoho CRM and no step inside Windsurf was run for this guide. No Zoho CRM organization is connected in the test workspaces, so the record below lists what was read instead.
| What was run | What came back |
|---|---|
| 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. This page quotes no Zoho response, record or error message from a test. |
| Cognition's pages | The Devin Desktop and Devin CLI documentation, both changelogs and the Windsurf redirects were read on November 14, 2026, and a second reader checked every quoted line against the rendered pages the same day. |
| Zoho's pages | Zoho's API v8 documentation, its MCP pages, the Claude directory listing and the Composio, Zapier, Windsor.ai and CData pages were read on November 14, 2026. |
Not run: any step inside Windsurf. Neither Devin Desktop nor the Devin CLI was opened, so the mcp_config.json entry, the Authenticate button, devin mcp add, devin mcp login and the approval card are described from Cognition's documentation as it read on November 14, 2026. No MCP client called a Zoho CRM tool through the Ryze AI connector either. Zoho's own servers and the Zoho MCP console were not set up; this guide describes them from Zoho's pages.
Windsurf and Zoho CRM errors and fixes
No Zoho CRM call was run, so there is no error message from a test to show. The Zoho error codes named below come from Zoho's API v8 pages, and none of them was seen in a test.
- The server shows Needs authentication
- Click Authenticate in the MCPs list to run the browser authorization again. In the Devin CLI, run devin mcp logout ryze and then devin mcp login ryze, and click Allow connection.
- Nothing happens after adding the server
- Refresh the MCP list in Customize, MCPs. Check that the entry sits under mcpServers and the JSON is valid. Running devin mcp list shows what the CLI reads.
- The server works in one project only
- A .devin/mcp_config.json entry applies to that repository. Put the server in ~/.config/devin/mcp_config.json for every project.
- The server stays disconnected on a team account
- When an admin keeps an MCP allowlist, every server outside it fails to connect and its tools are missing. Ask the admin to add the Ryze AI server to the allowlist.
- The agent is off in this folder
- A workspace opened in Restricted Mode has Devin Local and every ACP agent disabled, so the Ryze AI tools cannot run there.
- The Zoho CRM tools do not appear
- If Zoho CRM was connected in Ryze AI after the server was added, remove the ryze entry and add it again, then start a new session 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 the agent 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 the agent to read back each record in the response and report the ones that carry an error.
- The agent 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 for fewer and smaller queries.
- 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 the agent to find it and update it instead of creating a new one.
- The tools reply that a subscription is required
- The Zoho CRM tools need an active Ryze AI plan or free trial. Start the trial, then retry.
Terms on this page
- Devin Local
- The agent inside Windsurf (Devin Desktop) that calls MCP tools. It took over from Cascade.
- mcp_config.json
- Devin's MCP file. Each server is a named entry under mcpServers; this guide names the entry ryze.
- 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.
- Page token
- The next_page_token value Zoho hands back for lists longer than 2,000 records. It belongs to one user and stops working after 24 hours.
- 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: Devin Local overview, Zoho CRM API v8: COQL overview, Zoho CRM API v8: get records, Model Context Protocol. Checked November 14, 2026.
Frequently asked questions
How do I connect Windsurf to Zoho CRM?
Connect Zoho CRM in Ryze AI under Integrations by signing in to Zoho and approving access. Then add "ryze": {"url": "https://connector.get-ryze.ai/mcp"} to mcp_config.json, or run devin mcp add, and sign in with Authenticate or devin mcp login ryze.
Is there a Zoho CRM MCP server for Windsurf?
Yes, several. The Ryze AI connector at https://connector.get-ryze.ai/mcp has 4 Zoho CRM tools. Zoho offers four pre-built servers inside Zoho CRM, with a Windsurf setup page, and the Zoho MCP console for servers you build. Zapier and Composio are further options.
What is the Zoho CRM MCP server URL for Windsurf?
For the Ryze AI connector the address is https://connector.get-ryze.ai/mcp, the same for every user. Zoho's own servers have addresses you copy from Zoho CRM or the Zoho MCP console, and each one carries a key, so Zoho says to guard it like a password.
Which should I use, Ryze AI or Zoho MCP?
Use Ryze AI when you want Zoho CRM records and COQL next to other platforms on one connector URL; 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, and Zoho's pre-built servers add module, field and workflow changes.
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 Windsurf 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. Devin Local asks before each MCP tool call by default.
Can Windsurf 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.
Does Zoho have a Windsurf setup page?
Yes. Zoho's docs have a Windsurf page for its pre-built servers and the Zoho MCP implementation guide has Windsurf steps. They point to the older ~/.codeium/windsurf/mcp_config.json file and a serverUrl key, so check them against Devin's current docs before using them.
Which Windsurf plan do I need?
Cognition's MCP pages name none, and the Devin pricing page has no MCP row. On Teams and Enterprise an admin may keep an MCP allowlist, which would block a server outside it.
Is Windsurf the same as Devin Desktop?
Yes. Cognition renamed Windsurf to Devin Desktop on June 2, 2026, and its admin reference says both names mean the same product. The agent that calls MCP tools is Devin Local, which replaced Cascade.
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 Windsurf use up my Zoho CRM API credits?
Yes, each tool call reaches Zoho's API and is counted against the organization's credits for a rolling 24 hours. A COQL query costs 1 to 3 credits depending on its LIMIT, and a write costs 1 for every 10 records.
How much does it cost to connect Windsurf 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, Agency is $279 per month and Shopify CRO is $1,499 per month. Annual billing takes 30% off the first year.
How do I disconnect Zoho CRM from Windsurf?
Turn the ryze server off under Customize > MCPs, delete its entry, or run devin mcp remove ryze. To withdraw the Zoho side as well, Zoho's OAuth documentation says a user can revoke a client's delegated access at any time.
Sources
- Devin Desktop: MCP and customizations
- Devin CLI: MCP configuration
- Devin CLI: MCP overview
- Devin CLI: config file
- Devin CLI: read config from other tools
- Devin Local permissions
- Devin Local modes
- Devin Desktop admin controls
- Devin Desktop FAQ
- Zoho CRM MCP: overview
- Zoho CRM MCP: Windsurf setup
- Zoho CRM API v8: scopes
- Zoho CRM API v8: COQL overview
- Zoho CRM API v8: get records
- Zoho MCP: pricing
- Zapier MCP for Zoho CRM
- Composio Zoho toolkit
- CData zoho-crm-mcp-server
- Ryze AI help center: Zoho CRM
Zoho CRM pages checked November 14, 2026; Windsurf and Devin pages checked November 14, 2026.