By Ira Bodnar, Ryze AI · Updated · Connector tested November 13, 2026
Quick answer
The main way to connect Codex to Zoho CRM is the Ryze AI connector. Approve Zoho CRM once inside a Ryze AI workspace with your Zoho sign-in, run codex mcp add ryze --url https://connector.get-ryze.ai/mcp, then codex mcp login ryze and click Allow connection. Open a new session and ask a COQL question about your leads or deals.
- In Ryze AI open Integrations, find the Zoho CRM card and click Connect
- Sign in to Zoho on your data center and approve access to CRM
- In your terminal run the codex mcp add command, then codex mcp login ryze
- Allow the workspace on the Ryze AI page and ask your first CRM question
Codex to Zoho CRM at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, a hosted MCP server that the Codex CLI, the ChatGPT desktop app and the Codex IDE extension all reach at the same URL |
| Server address | https://connector.get-ryze.ai/mcp |
| Sign-in | OAuth in the browser, started by codex mcp login ryze or by Authenticate in the app or extension. Codex documents dynamic client registration and the connector lists a register endpoint, so on paper no client ID is needed. A Ryze AI rk_live_ key in bearer_token_env_var is the keyed alternative |
| Zoho CRM tools | 4: zoho__read and zoho__query read, zoho__write writes, zoho__delete deletes |
| Can Codex change the CRM | Yes. Records can be created, updated or upserted, 100 per call, and deleted into the recycle bin. Fields, layouts, modules and workflow rules stay out of reach |
| Zoho access requested | 5 OAuth scopes: ZohoCRM.modules.ALL, ZohoCRM.settings.ALL, ZohoCRM.users.READ, ZohoCRM.org.READ and ZohoCRM.coql.READ |
| Other platforms in the same session | Tools for any other platform connected in the same Ryze AI workspace, such as Google Ads or Meta Ads, come through the same URL |
| Codex plan | Included in ChatGPT Free, Go, Plus, Pro, Business, Edu and Enterprise. In OpenAI's feature table the MCP row is ticked from Plus upward and for API keys |
| Ryze AI price | Paid Ads at $89 per month after a 7-day free trial. The connector costs nothing to add; the Zoho CRM tools need a plan or trial |
| Zoho's own option for Codex | None of Zoho's pages names Codex. Its directory connector targets Claude, and its pre-built servers and Zoho MCP console document other assistants |
| Last tested | November 13, 2026: the connector's sign-in answer and discovery files only. No Zoho CRM call and no Codex step was run |
Before you start
- Codex access. OpenAI includes ChatGPT Work and Codex in the Free, Go, Plus, Pro, Business, Edu and Enterprise plans. The Free and Go cards list Codex in the desktop app only, subject to rollout, so follow the desktop steps there. Plus and higher add the CLI and the IDE extension. An OpenAI API key also runs Codex in the CLI, SDK or IDE extension at API pricing. OpenAI's MCP page sets no plan condition for adding a server, while the pricing page's feature table marks MCP for Plus, Pro, Business, Enterprise and Education and for API key use, with no column for Free or Go.
- A Zoho login that can approve the access. Ryze AI asks Zoho for access to CRM modules, settings, users and organization details. Any Zoho data center works, including US, EU, India and Australia. Connect with a login whose reach in Zoho CRM you are comfortable sharing with Codex.
- A Ryze AI plan or 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. The connector itself is free to add; the Zoho CRM tools need an active plan or trial.
How to connect Codex to Zoho CRM
Two steps happen in Zoho and Ryze AI, four in Codex. 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, use the CRM filter to find the Zoho CRM card and click Connect.
Sign in to Zoho and approve the access
Sign in to Zoho on the data center that holds your CRM organization, then approve access to CRM modules, settings, users and organization details. The card in Ryze AI then shows Connected, and View shows the organization name.
Add the connector to Codex
Open a terminal and run codex mcp add ryze --url https://connector.get-ryze.ai/mcp. The name ryze is yours to choose. The Codex CLI, the ChatGPT desktop app and the IDE extension share one MCP configuration, so the server shows up in all three.
Sign in from Codex
Run codex mcp login ryze. A Ryze AI sign-in page opens in the browser. On a machine without a local browser, add --no-browser, open the printed URL elsewhere and paste the full redirect URL back into the terminal. Inside a running CLI session, /mcp login ryze starts the same sign-in.
Allow the workspace
Sign in on the Ryze AI page if it asks, choose the workspace where you connected Zoho CRM and click Allow connection. Then run codex mcp list, or type /mcp inside the Codex TUI, to see the server.
Start a new session and ask your first question
Try: Run a COQL query that counts Leads created this month by Lead Source. If you added the server before connecting Zoho CRM, remove it and add it again so the tool list refreshes.
The Ryze AI Zoho CRM guide covers the Zoho side of the connection, and the Codex MCP docs cover the client commands. Checked November 14, 2026.
CLI, desktop app, IDE and config.toml
Codex reaches the Ryze AI connector from every local surface, and all of them share one configuration. Pick the one you work in.
Codex CLI
codex mcp add ryze --url https://connector.get-ryze.ai/mcp
codex mcp login ryzeUse this on your own machine. After login, codex mcp list shows the server and /mcp inside the TUI does the same. In a remote shell, codex mcp login ryze --no-browser prints a URL to open on another device.
ChatGPT desktop app (Codex)
Open Settings, then MCP servers, then Add server. Enter the name ryze, choose Streamable HTTP and enter https://connector.get-ryze.ai/mcp. Save and select Restart. The server list marks the servers that still need OAuth; select Authenticate for ryze and finish the Ryze AI sign-in. Type /mcp in the composer to view connected servers.
Codex IDE extension
Open the gear menu, then MCP servers, then Add server, with the same name, Streamable HTTP type and URL. Save, select Restart extension, then Authenticate and complete the Ryze AI sign-in. OpenAI notes that plugins are not available in the IDE extension, while MCP servers configured in config.toml are.
config.toml with OAuth
[mcp_servers.ryze]
url = "https://connector.get-ryze.ai/mcp"Edit ~/.codex/config.toml, or a project .codex/config.toml in a trusted project, then run codex mcp login ryze. OAuth is the default for HTTP servers, and Codex supports both client ID metadata documents and dynamic client registration.
config.toml with a Ryze AI API key
[mcp_servers.ryze]
url = "https://connector.get-ryze.ai/mcp"
bearer_token_env_var = "RYZE_API_KEY"Set the RYZE_API_KEY environment variable to your Ryze AI rk_live_ key and keep it out of repositories and shell history. This suits unattended setups. The key authenticates you to Ryze AI and has no link to your Zoho login.
Timeouts and output size
Codex waits 10 seconds for a server to start (startup_timeout_sec) and 60 seconds for a tool call (tool_timeout_sec). Raise either per server in config.toml if a large COQL query runs long. tools.<tool>.output_token_limit sets an output budget for one tool, which helps when a query returns up to 2,000 rows. This page covers the CLI, the desktop app and the IDE extension. OpenAI's MCP page warns that local MCP servers and transports may not be available in the cloud, and its Codex Cloud page does not mention MCP, so this guide makes no claim about Codex cloud tasks.
Codex and MCP: the facts in one table
| Topic | What OpenAI's Codex documentation says |
|---|---|
| Where you add a server | codex mcp add in the CLI, Settings > MCP servers in the ChatGPT desktop app, and the gear menu > MCP servers in the IDE extension |
| Where the entry lives | ~/.codex/config.toml, or .codex/config.toml inside a project you have marked as trusted. Each server gets one [mcp_servers.<name>] table |
| Shared setup | The CLI, the desktop app and the IDE extension read the same configuration, so one entry serves all three |
| Transports | STDIO for a local command and Streamable HTTP for an address. The MCP page does not mention SSE |
| Sign-in for a remote server | OAuth by default, with Codex registering through CIMD or dynamic client registration. A bearer token read from an environment variable, or a pre-registered client ID passed with --oauth-client-id, also work |
| Scopes Codex asks for | Those named in the server's first WWW-Authenticate challenge, then those in its protected resource metadata, unless you set scopes or pass --scopes |
| OAuth callback | A loopback address on 127.0.0.1 on a port the operating system picks, unless mcp_oauth_callback_port is set |
| Tool approval | default_tools_approval_mode takes auto, prompt, writes or approve, and tools.<tool>.approval_mode overrides it for one tool. A tool that declares itself destructive always needs approval, unless it also carries a read annotation |
| Allow and deny lists | enabled_tools and disabled_tools, with the deny list applied after the allow list |
| Default waits | 10 seconds for a server to start and 60 seconds per tool call |
| Admin control | An admin can put an mcp_servers approved list in requirements.toml from Admin Console > Agent Security > Edit as TOML. A remote server runs only when its name and URL both match, and an empty list switches every server off |
| Plugins | One directory shared with ChatGPT, opened with /plugins in the CLI or the Plugins tab in the desktop app. The IDE extension has none |
Sources: Codex MCP documentation, Codex CLI command reference, configuration reference, approvals and security, auto-review, managed configuration, plugins and pricing. Checked November 14, 2026.
Claude, ChatGPT and Cursor
The same URL works in other MCP clients. Zoho CRM is connected once in Ryze AI, so nothing changes on the Zoho side.
Claude and Claude Code
In Claude on the web or Desktop, open Customize, Connectors, click + Add, choose Add custom connector and enter https://connector.get-ryze.ai/mcp. Claude Code has its own guide, linked below.
ChatGPT
ChatGPT on the web does not read Codex's config.toml. There the connector is added on the Plugins page: select the plus button, then Add custom MCP server, enter https://connector.get-ryze.ai/mcp with OAuth and select Create as a plugin. The Ryze AI help center still describes the older route, a custom app under Settings, Apps. OpenAI's help center gives full custom MCP support to ChatGPT Business and Enterprise/Edu, and Pro can connect custom MCP servers with read and fetch permissions only.
Cursor
Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project). Cursor runs OAuth with PKCE and asks for approval before using MCP tools by default.
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Zoho permissions and scopes
Connecting Zoho CRM is a Zoho OAuth sign-in done in Ryze AI rather than in Codex, so Codex never sees your Zoho password. Three points decide how much Codex can reach.
- Which login
- Ryze AI receives the access of the Zoho user who signs in, and that user's own Zoho CRM permissions still apply under the five scopes. Zoho documents a NO_PERMISSION error when the user may not read a module's records, keeps the Notes module to admin users, and names the profile permission Zoho CRM API Access as a requirement for COQL. Use a login whose reach you would accept for Codex.
- Which organization
- Each connection is one Zoho CRM organization. Ryze AI documents attaching more organizations to a workspace with View, then Add one more account. One is the primary and is used unless a prompt names another, and the tools accept an optional connection_id.
- How long it lasts
- Zoho says an access token is valid for an hour, while a refresh token has an unlimited lifetime until the end user revokes it. Ryze AI renews access automatically, so the connection keeps working until the Zoho user withdraws it.
The 5 Zoho scopes Ryze AI requests
Ryze AI asks Zoho for five OAuth scopes. Zoho spells each one as service, scope name and operation, where the operation is ALL, CREATE, READ, UPDATE or DELETE. The middle column follows Zoho's scope reference; the Zoho consent screen has the final word.
| Zoho scope | What Zoho's reference says it covers | What the Ryze AI tools use it for |
|---|---|---|
| ZohoCRM.modules.ALL | Read, create, update and delete records in every module, Leads, Contacts, Accounts, Deals, Tasks, Products, Quotes, Invoices and custom modules among them | Record reads, COQL results, writes and deletes |
| ZohoCRM.settings.ALL | Every settings scope: fields, layouts, custom views, related lists, tags, variables, roles, profiles, territories, currencies and more. Field metadata and the module list are read under it | zoho__read looks up modules and fields. No tool changes settings |
| ZohoCRM.users.READ | Get user data, with no changes to users | zoho__read lists users, for example to put names on owner IDs |
| ZohoCRM.org.READ | Get organization data, with no changes to the organization | zoho__read can fetch the organization details |
| ZohoCRM.coql.READ | Run COQL queries. Zoho requires a modules scope next to it, and a fields scope to read field metadata | zoho__query |
Absent from the request, going by Zoho's full scope list: ZohoCRM.bulk, which covers the Bulk Read and Bulk Write APIs, ZohoCRM.notifications, and any write access to users or to the organization. So Codex cannot start a bulk export or change a user through this connection. The consent screen itself was not seen for this guide.
The settings scope is broad, but the Ryze AI tools documented for Zoho CRM act on records. Do not plan on module or settings changes through Codex.
Sources: Ryze AI Zoho CRM guide, Zoho's scope reference, OAuth overview, get records and COQL query pages. Checked November 14, 2026.
Removing access
To pause the connector in Codex, set enabled = false in the [mcp_servers.ryze] table; the entry stays for later. To remove it, run codex mcp logout ryze to clear the stored sign-in and codex mcp remove ryze to delete the entry, or remove the server under MCP servers in the desktop app or IDE extension. On the Zoho side, Zoho says a user can revoke a client's delegated access at any time, and the refresh token belongs to the user who approved it, so that user does the revoking. This guide did not check the menu path in Zoho or a disconnect step in Ryze AI.
What Codex can do in Zoho CRM
Codex gets 4 Zoho CRM tools through the Ryze AI connector: 2 read, 1 write and 1 delete. All of them act on the organization you connected.
| Tool | Type | What it does |
|---|---|---|
| zoho__read | Read | Sends a GET request to any Zoho CRM API resource, such as module records, a single record, module settings, fields or users. |
| zoho__query | Read | Runs a COQL query, a SQL-like select over CRM modules, returning up to 2,000 rows per call. |
| zoho__write | Write | Creates, updates or upserts Zoho CRM records, up to 100 records per call. |
| zoho__delete | Delete | Deletes Zoho CRM records singly or in bulk. Deleted records go to the Zoho CRM recycle bin. |
Codex decides per server whether to stop before a tool runs. In the [mcp_servers.ryze] table, default_tools_approval_mode takes auto, prompt, writes or approve, and tools.<tool>.approval_mode changes it for a single tool. OpenAI explains only writes in words: Codex then asks before any tool that is not marked read-only. Whether each Ryze AI tool carries that mark was not checked, so the firm control is the deny list: put zoho__delete in disabled_tools and Codex no longer sees the tool. If you pick Approve for me with the permissions control under the composer, or with /permissions in the CLI, calls that need approval go to a reviewer agent instead of to you. Inside the Ryze AI chat the Tool approvals setting begins on Skip all approvals, so switch it to Approve write & delete or Manual approve if you want a prompt there. Ryze AI scheduled tasks run without an approval step.
Zoho API limits in numbers
Zoho counts API credits per CRM organization over a rolling 24-hour window, and it counts concurrent calls per organization and app. The numbers below are Zoho's, from its API v8 documentation, and they are separate from Ryze AI pricing. This guide could not confirm which Zoho API version the Ryze AI tools call. Their 2,000-row and 100-record caps match Zoho's figures.
| Limit | What Zoho documents | Source |
|---|---|---|
| Credits, Free edition | 5,000 per rolling 24 hours, with 5 calls at once | Zoho API limits |
| Credits, Standard and Starter | 50,000 plus 250 per user license and any add-on credits, capped at 100,000, with 10 calls at once | Zoho API limits |
| Credits, Professional | 50,000 plus 500 per user license and add-ons, capped at 3,000,000, with 15 calls at once | Zoho API limits |
| Credits, Enterprise and Zoho One | 50,000 plus 1,000 per user license and add-ons, capped at 5,000,000, with 20 calls at once | Zoho API limits |
| Credits, Ultimate and CRM Plus | 50,000 plus 2,000 per user license and add-ons, with no cap and 25 calls at once | Zoho API limits |
| Heavy calls at once | 10 in every edition for COQL queries, writes of more than 10 records, Convert Lead and a few other calls. Going over returns TOO_MANY_REQUESTS | Zoho API limits |
| Calls per minute | No cap. Only credits and concurrent calls are limited | Zoho API limits |
| COQL credits | 1 for LIMIT 1 to 200, 2 for 201 to 1,000, 3 for 1,001 to 2,000 | Zoho API limits |
| Write credits | 1 for every 10 records inserted, updated or upserted, so at most 10 per call | Zoho API limits |
| Other credit costs | Mass delete by ID: 1 per 100 records. Convert Lead: 5. Record count of a module: 50 | Zoho API limits |
| Credits left | Responses carry an X-API-CREDITS-REMAINING header once half the daily credits are used. A super admin can add pay-as-you-go credits from the API Dashboard | Zoho API limits |
| COQL rows | LIMIT defaults to 200 and tops out at 2,000. LIMIT with OFFSET pages through 100,000 records per set of criteria; past that, add a criterion on the record ID or use the Bulk Read API | COQL overview |
| COQL query size | 500 fields in SELECT, 25 criteria in WHERE, 10 fields in ORDER BY, 4 in GROUP BY, 5 aggregates and 100 values in an IN list. Joins through lookup fields are limited as well | COQL limitations |
| Get Records | 200 records per page. The fields list is required and holds 50 API names at most. Past 2,000 records a page_token is needed, valid 24 hours, up to 100,000 records | Get records |
| Records per write | 100 per insert, update or upsert call. A batch where some records fail answers HTTP 207 with one result per record | Insert records |
| Automation on writes | Unless the call sends an empty trigger list, inserts and upserts run the module's workflows, approvals and blueprints | Upsert records |
| Records per delete | 100 per call. Workflow rules run on deletion unless the call turns them off | Delete records |
| Recycle bin | Deleted records can be restored for 60 days, then Zoho removes them for good | Zoho recycle bin |
| Zoho access token | Valid for 1 hour. The refresh token lasts until the user revokes it | Token validity |
Each row links the Zoho page it comes from. Checked November 14, 2026.
First 3 prompts to run
Zoho rejects list calls that do not name the fields to return, so each prompt below says which fields it wants. Results come from your own organization, which is why this page describes the output and shows no sample figures.
1. Open deals for a pipeline review
Run a COQL query on Deals where Stage is not Closed Won or Closed Lost. Return Deal_Name, Amount, Stage, Closing_Date and the owner, limited to 200 rows.
Tools used: zoho__query
What comes back: A table of open deals with the fields you listed. A LIMIT of 200 or less counts as 1 API credit in Zoho's published pricing for COQL.
2. Lead sources for the month
Count the Zoho CRM Leads created this month, grouped by Lead_Source, and list the sources from highest count to lowest.
Tools used: zoho__query
What comes back: One row per lead source with a count, built from the leads in your organization.
3. Correct one contact record
Find the Zoho CRM contact with the email I name next and show its Phone and Title. Describe the change you would make and ask me to confirm before you write it.
Tools used: zoho__query or zoho__read, then zoho__write
What comes back: The current values and a request to confirm. The write happens after you answer; whether Codex also stops before the tool call depends on the approval mode you set for the server.
Deleting uses its own tool, so name the module and the action when you want it, and add zoho__delete to disabled_tools in config.toml if Codex should never delete. Zoho keeps deleted records in the CRM recycle bin for 60 days. A write can come back with a 200 response that still holds errors for single records, and Zoho documents HTTP 207 for a batch where some records fail, so ask Codex to report the status of each record.
10 jobs to hand to Codex
Ten jobs to give Codex in Zoho CRM, each with the Ryze AI tool it calls. None was run for this guide. In the last column, yes means the five scopes of the default connection cover the call according to Zoho's documentation.
| Job | Ask Codex | Tool | Works on the default connection |
|---|---|---|---|
| One record in full | Show the deal whose ID I paste, with its subform rows. | zoho__read | Yes. Zoho returns subforms only when a single record is fetched |
| Move deals to a new stage | Find the deals I describe, list them for me, and after I confirm, set their Stage to the value I give. | zoho__query, then zoho__write | Yes, up to 100 records per call |
| Deals with account fields | In one COQL query, return each open deal together with fields from its linked account. | zoho__query | Yes, within Zoho's limit on joins |
| Amount by stage | Total the Amount of open deals for each Stage. | zoho__query | Yes |
| Field API names | List the fields of the Leads module with their API names before you write the query. | zoho__read | Yes |
| Owner names | List the CRM users so the owner IDs in that report get names. | zoho__read | Yes |
| Import new leads | Create these leads in batches of 100 and give me the status of every record. | zoho__write | Yes. It changes live data |
| Merge a contact list | Upsert these contacts, matching on Email, so known ones update and new ones are added. | zoho__write | Yes. Email is Zoho's default duplicate check for contacts |
| Clean up test data | Delete the test leads whose IDs I paste. | zoho__delete | Yes. They stay restorable in the recycle bin for 60 days |
| Add a custom field | Add a Renewal_Date field to the Deals module. | None | No. The write tool handles records only; Zoho's Module Customization server covers fields |
3 ways to connect Codex to Zoho CRM
Three ways can bring a Zoho CRM organization into Codex today: the Ryze AI connector and two hosted services, Composio and Zapier MCP, whose pages name Codex. This guide uses the Ryze AI connector as the main way, because Zoho is approved once in Ryze AI and Codex needs a single URL that its three local surfaces share. Zoho's own three routes and two other servers follow the table, since their pages do not name Codex. Every vendor page was read on November 14, 2026, and none of these ways was installed in Codex for this guide.
| Way | Runs where | Setup in Codex | What it reaches in Zoho CRM | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI, one URL for every user. The same URL also works in Claude, ChatGPT and Cursor | codex mcp add ryze --url https://connector.get-ryze.ai/mcp and codex mcp login ryze, or Add server with Streamable HTTP in the desktop app or IDE extension and then Authenticate. A Ryze AI key in bearer_token_env_var covers unattended runs | 4 tools: GET reads of any CRM API resource, COQL up to 2,000 rows, create, update and upsert of up to 100 records, and deletes into the recycle bin. Several organizations per workspace. Zoho CRM records only | Paid Ads at $89 per month with a 7-day free trial. Adding the connector is free |
| Composio | Hosted | Composio's Zoho toolkit links a framework page for Codex, which was not opened for this guide. Its Claude Code page builds an MCP URL with the Composio SDK and sends a Composio API key in an X-API-Key header, a header Codex can send through env_http_headers. Zoho is linked through Composio's managed OAuth app or your own | 113 tools on its toolkit page: COQL, search, record create, update, upsert and delete up to 100 per call, notes, tags, attachments, workflow rules, custom fields, layouts, functions and users | Free: $2 of credits once and up to 10,000 tool calls a month. Standard: $18 per seat per month. Extra calls $0.005 each |
| Zapier MCP | Hosted | Zapier's quickstart lists Codex among popular MCP clients and needs Streamable HTTP, which Codex has. You add Zapier as a server, sign in and switch on the Zoho CRM actions you want. A Zapier account is required. This guide did not follow Zapier's setup inside Codex | The Zoho CRM actions you enable, such as Create Module Entry, Update Module Entry, Convert Lead, Add Tag, Add Attachment and API Request (Beta). No delete action shows in the visible part of the list | 2 Zapier tasks per successful call, none for failed ones. Free has 100 tasks a month; Professional starts at $19.99 a month |
Options that do not fit Codex
- Zoho's Zoho CRM connector in Claude's directory. Built by Zoho, marked Anthropic verified, with 41 tools and one address per Zoho region. The listing lives in Claude's own directory and speaks only about Claude.
- Zoho CRM's four pre-built MCP servers: Data Insights, Data Operations, Module Customization, and Workflow & Process Automation, installed from Setup > Developer Hub > MCP for AI Agents. Zoho says they work with any AI tool that supports MCP, yet its setup pages cover only Cursor, Claude Desktop, VS Code and Windsurf. A Zoho sign-in opens on the first tool call, their calls spend the organization's API credits, actions stay within the user's CRM role, and they reach fields, layouts and workflow rules, which the Ryze AI tools do not.
- The Zoho MCP console, where you assemble your own server from Zoho CRM tools, 1,319 of them in Zoho's tool manual, plus tools from other Zoho and third-party services. Zoho's implementation guide has steps for Claude, ChatGPT, Cursor, Windsurf and VS Code and says nothing about Codex. By default each user signs in with their own Zoho account. The server URL holds an API key that Zoho says to treat like a password. The pricing page lists the service at $0.
- Windsor.ai. Its Zoho CRM pages give steps for ChatGPT and Claude only and describe pulling CRM data for analysis, with no word on changing records.
- CData's open-source Zoho CRM server. A local, read-only Java server with 3 tools that needs a separately licensed CData JDBC driver. Codex can start local commands, but the README covers Claude Desktop only, so the pairing is untested. 3 GitHub stars, last push October 18, 2025.
Which one to pick
Ryze AI is the best way to connect Codex to Zoho CRM for record work, such as COQL reports, batched creates and updates and cleanup across one or several organizations, with one caveat: it covers Zoho CRM records only, so new fields, layouts, modules, workflow rules and other Zoho apps are out of its reach. Setup is two commands that every Codex surface shares. It needs a Ryze AI plan or trial, and your CRM data passes through the hosted Ryze AI server on its way to Codex. Zoho's pre-built servers and the Zoho MCP console handle those jobs, the console at $0 on Zoho's pricing page and the servers for the API credits their calls use, but Zoho documents them for other assistants, so running them in Codex is untested ground. Composio suits a team that already routes other apps through it and wants its workflow, field and layout tools. Zapier MCP suits a team whose automations already live in Zapier and can spend two tasks per call.
Sources: Zoho CRM MCP servers, Zoho CRM in Claude's directory, Zoho MCP implementation guide, Zoho MCP pricing, Zoho MCP tool manual, Composio Zoho toolkit, Composio Claude Code page, Composio pricing, Zapier Zoho CRM MCP, Zapier MCP quickstart, Zapier MCP usage, Zapier pricing, Windsor.ai for ChatGPT, Windsor.ai for Claude, CData Zoho CRM MCP server, Codex MCP, Codex pricing, Ryze AI Zoho CRM guide. Checked November 14, 2026.
Zoho CRM, Codex and MCP: dates that matter
| Date | What happened |
|---|---|
| July 17, 2025 | Zoho announced its own MCP server in a press release, with more than 15 Zoho tools in early access. |
| September 23, 2025 | The Codex CLI 0.40.0 release notes stated a 60-second default timeout for MCP tool calls and named tool_timeout_sec as the per-server override. |
| October 3, 2025 | Codex CLI 0.44.0 added Streamable HTTP MCP servers, the transport the Codex steps on this page use. |
| October 6, 2025 | Codex CLI 0.45.0 brought experimental OAuth sign-in for MCP servers. |
| March 9, 2026 | Zoho published the launch post for Zoho MCP, its service for building MCP servers. |
| March 2026 | The Zoho CRM connector made by Zoho appeared in Claude's connector directory. The listing gives the month only. |
| April 6, 2026 | Zoho announced MCP servers built into Zoho CRM, rolling out to data centers in phases. |
| July 9, 2026 | Codex became part of the ChatGPT desktop app in release 26.707, which is why the desktop steps name ChatGPT. |
| September 1, 2026 | Codex CLI 0.152.0 added output_token_limit for single MCP tools. |
| October 7, 2026 | Codex CLI 0.161.0 added /mcp login <name> for signing in from a running session. |
| October 2026 | The latest Zoho CRM release in the Zoho MCP changelog added 95 tools and removed 85. |
| November 13, 2026 | Codex CLI 0.169.0 came out, still the newest the next day. It keeps project MCP servers off for codex exec in untrusted directories. |
| November 14, 2026 | Zoho's tool manual listed 1,319 Zoho CRM tools for Zoho MCP, the Claude directory listing showed 41, Zoho's docs listed four pre-built servers and Zoho MCP's pricing page said $0. |
Sources: Zoho press release, July 2025, Zoho MCP launch post, Claude directory listing, Zoho community announcement, Zoho MCP changelog, Zoho MCP tool manual, Zoho MCP pricing, Codex CLI 0.40.0, 0.44.0 and 0.45.0 release notes, Codex changelog. Checked November 14, 2026.
How this guide was tested
The checks behind this guide were made against the Ryze AI connector itself, from outside any assistant, on November 13, 2026. No Zoho CRM organization was connected, so the record has two rows.
| What was run | What came back |
|---|---|
| A request to https://connector.get-ryze.ai/mcp with no sign-in | HTTP 401 with a WWW-Authenticate header pointing to the sign-in details. |
| The two discovery files on the connector's host | Both loaded. They list the authorize, token and register endpoints, the authorization code and refresh token grants, PKCE with S256, and the scopes mcp:read and mcp:write. |
Not run: any Zoho CRM call. No Zoho CRM test account was connected, so no Zoho response is quoted on this page. The four tool names come from the Ryze AI app source; the live tool list was not seen. Nothing was run in Codex either: the codex mcp add and codex mcp login commands, the menus in the desktop app and IDE extension and the Allow connection page were not tried, and the connector has not been tested end to end in Codex. Those steps follow OpenAI's documentation as read on November 14, 2026 and Ryze AI's setup notes. On paper the two fit: OpenAI's MCP page says Codex takes the scopes from the server's first WWW-Authenticate challenge and registers itself when the server offers a register endpoint. If Codex behaves differently, tell Ryze AI support.
Errors and fixes
No Zoho CRM call was run for this guide. The error codes below come from Zoho's API documentation.
- Zoho CRM does not show Connected in Ryze AI
- Repeat the sign-in on the data center that holds your CRM organization and approve every requested access. Any data center works, but the login must belong to that organization.
- codex mcp login cannot open a browser
- Run codex mcp login ryze --no-browser, open the printed URL on another device and paste the full redirect URL back into the terminal.
- The server times out while starting or answering
- Codex allows 10 seconds for startup and 60 seconds per tool call by default. Raise startup_timeout_sec or tool_timeout_sec in the [mcp_servers.ryze] table.
- The server is missing in the desktop app or IDE
- The CLI, desktop app and IDE extension share one configuration. Select Restart (or Restart extension) after adding the server, then select Authenticate.
- The API key is rejected
- Confirm bearer_token_env_var names an environment variable that is set in the shell that starts Codex, that it holds a live rk_live_ Ryze AI key, and that the URL ends in /mcp. Or remove the line and use OAuth.
- No Zoho CRM tools appear
- Remove the server, add it again and open a new session if you registered it before connecting Zoho CRM. Check that disabled_tools does not list the tool and that enabled_tools, if set, includes it.
- A list call is rejected
- Zoho rejects list calls that name no fields, with the code REQUIRED_PARAM_MISSING, and more than 50 field names returns LIMIT_EXCEEDED. Ask Codex for the exact field API names you need, or use a COQL query.
- Only 2,000 records come back
- Page-based pagination stops at 2,000 records, and Zoho documents DISCRETE_PAGINATION_LIMIT_EXCEEDED for a call that goes further without a page token. Narrow the query, or ask for results in batches.
- A write says success but a record is unchanged
- A 200 response can still hold errors for single records. Ask Codex to list the per-record status from the response.
- Zoho returns a limit error under heavy use
- Zoho caps daily credits and concurrent calls by edition, per organization, and documents HTTP 429 with TOO_MANY_REQUESTS when either runs out. Run fewer parallel requests and trim large jobs. Check the limits table above for your edition.
- Codex says a subscription is required
- The Zoho CRM tools need an active Ryze AI plan or free trial. Start the trial in Ryze AI and retry.
Terms on this page
- MCP
- Model Context Protocol, the open standard Codex uses to call outside tools. The Ryze AI connector is an MCP server hosted by Ryze AI, so there is no server to install on your machine.
- config.toml
- The Codex settings file. Each MCP server gets its own [mcp_servers.<name>] table there, read by the CLI, the desktop app and the IDE extension.
- COQL
- CRM Object Query Language, Zoho CRM's SQL-like SELECT language. It names modules and fields by their API names and can join modules through lookup fields.
- API name
- The fixed name Zoho gives a module or field for API calls, such as Deal_Name. Zoho lists them under Setup > Developer Hub > APIs and SDKs > API Names.
- API credit
- Zoho CRM's unit of API use. Most calls cost 1, and each edition gets an allowance per rolling 24 hours.
- Scope
- A permission an app asks Zoho for at sign-in, written as service, scope name and operation, for example ZohoCRM.coql.READ.
- Recycle bin
- Where Zoho CRM puts deleted records. They can be restored for 60 days.
Sources: Zoho's COQL overview, scopes, API limits and recycle bin pages, Codex MCP documentation, modelcontextprotocol.io. Checked November 14, 2026.
Frequently asked questions
How do I connect Codex to Zoho CRM?
Connect Zoho CRM to a Ryze AI workspace first. Then run codex mcp add ryze --url https://connector.get-ryze.ai/mcp and codex mcp login ryze, and finish on the Ryze AI page by choosing the workspace and clicking Allow connection.
Is there a Zoho CRM Codex connector or MCP server?
Not one that Zoho names for Codex: none of Zoho's MCP pages mentions it. Zoho offers a Zoho CRM connector in Claude's directory, four pre-built MCP servers inside Zoho CRM with setup pages for Cursor, Claude Desktop, VS Code and Windsurf, and the Zoho MCP console for building your own server. The Ryze AI connector is a separate route with 4 Zoho CRM tools that Codex reaches through one URL.
Which Zoho CRM connector should I use with Codex?
Ryze AI is the best Zoho CRM connector for Codex when the work is records and COQL reports and you want one URL that every Codex surface shares, but it covers Zoho CRM records only and needs a Ryze AI plan. Zoho's own servers also change fields, layouts and workflow rules, and the Zoho MCP console is listed at $0, though Zoho documents them for other assistants. Composio and Zapier MCP name Codex on their pages and bill on their own plans.
Which plan do I need for Codex?
OpenAI includes Codex in the ChatGPT Free, Go, Plus, Pro, Business, Edu and Enterprise plans. Free and Go list it in the desktop app only, subject to rollout. Plus and higher add the CLI and IDE extension. An OpenAI API key also works in the CLI, SDK or IDE extension at API pricing. The feature table on OpenAI's pricing page marks MCP for Plus, Pro, Business, Enterprise and Education and for API key use.
What Zoho permissions do I need?
You need a Zoho login that can approve access to CRM modules, settings, users and organization details for your organization. Any Zoho data center works. That user's own CRM role still limits what the connection can read or change, and Zoho's COQL page names the profile permission Zoho CRM API Access as required.
Should I use OAuth or an API key?
OAuth is the default for HTTP servers in Codex and the easier path when you sit at the machine. An API key suits unattended setups. Set bearer_token_env_var to the name of an environment variable that holds your rk_live_ Ryze AI key. The key has nothing to do with your Zoho login.
Can Codex edit or delete Zoho CRM records?
Yes. The connector has a write tool that creates, updates or upserts up to 100 records per call and a delete tool that removes records singly or in bulk into the Zoho CRM recycle bin. Choose an approval mode for the server in config.toml, or list zoho__delete in disabled_tools, if you want control over each change.
How many records can one COQL query return?
Up to 2,000 rows per call. Zoho's COQL LIMIT defaults to 200 and tops out at 2,000, and it prices a query at 1 to 3 API credits depending on the LIMIT. OFFSET pagination reaches 100,000 records per criteria, after which Zoho points to its Bulk Read API.
Can Codex run COQL queries against Zoho CRM?
Yes, through the zoho__query tool. COQL only reads: SELECT is its one statement. A query can hold up to 25 criteria in WHERE, use aggregates such as COUNT and SUM, and join modules through lookup fields within Zoho's limits. Name fields by their API names, and ask Codex to list them first with zoho__read if you do not know them.
Can I connect more than one Zoho CRM organization?
Yes. Click View on the Zoho CRM card in Ryze AI and choose Add one more account. One organization is the primary and is used unless you name another, and the tools accept an optional connection_id.
Does it work if my Zoho account is in the EU or India data center?
Yes. Ryze AI says any Zoho data center works, including US, EU, India and Australia. Sign in on the data center that holds your CRM organization, because Zoho keeps each account's data in the data center where it was registered.
Do the CLI, desktop app and IDE extension need separate setup?
No. OpenAI says the ChatGPT desktop app, Codex CLI and IDE extension share MCP configuration for the same Codex host, so a server added in one appears in the others. You still sign in once through whichever surface you used.
Why are the Zoho CRM tools missing in Codex?
If you added the server before connecting Zoho CRM in Ryze AI, its tool list is out of date. Run codex mcp remove ryze, add it again with codex mcp add, sign in and open a new session. Also check that disabled_tools in the [mcp_servers.ryze] table does not list them.
Does this work in Codex cloud tasks?
Unknown. OpenAI's MCP page says local MCP servers and transports may not be available in the cloud, its Codex Cloud page does not mention MCP, and the connector was not tested there, so this guide covers only the CLI, desktop app and IDE extension.
How much does it cost?
Connecting the connector is free, 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.