How to connect Codex to Zoho CRM

Connect your Zoho CRM organization once in Ryze AI, add one MCP URL to Codex, then run COQL queries and edit leads, contacts and deals from the CLI, the desktop app or your IDE.

Your MCP URL
https://connector.get-ryze.ai/mcp

Use it with codex mcp add ryze --url. See the steps

See pricing

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.

  1. In Ryze AI open Integrations, find the Zoho CRM card and click Connect
  2. Sign in to Zoho on your data center and approve access to CRM
  3. In your terminal run the codex mcp add command, then codex mcp login ryze
  4. Allow the workspace on the Ryze AI page and ask your first CRM question

Codex to Zoho CRM at a glance

FactDetail
Main way to connectThe 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 addresshttps://connector.get-ryze.ai/mcp
Sign-inOAuth 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 tools4: zoho__read and zoho__query read, zoho__write writes, zoho__delete deletes
Can Codex change the CRMYes. 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 requested5 OAuth scopes: ZohoCRM.modules.ALL, ZohoCRM.settings.ALL, ZohoCRM.users.READ, ZohoCRM.org.READ and ZohoCRM.coql.READ
Other platforms in the same sessionTools for any other platform connected in the same Ryze AI workspace, such as Google Ads or Meta Ads, come through the same URL
Codex planIncluded 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 pricePaid 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 CodexNone of Zoho's pages names Codex. Its directory connector targets Claude, and its pre-built servers and Zoho MCP console document other assistants
Last testedNovember 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.

  1. 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.

  2. 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.

  3. 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.

  4. 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.

  5. 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.

  6. 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 ryze

Use 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

TopicWhat OpenAI's Codex documentation says
Where you add a servercodex 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 setupThe CLI, the desktop app and the IDE extension read the same configuration, so one entry serves all three
TransportsSTDIO for a local command and Streamable HTTP for an address. The MCP page does not mention SSE
Sign-in for a remote serverOAuth 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 forThose named in the server's first WWW-Authenticate challenge, then those in its protected resource metadata, unless you set scopes or pass --scopes
OAuth callbackA loopback address on 127.0.0.1 on a port the operating system picks, unless mcp_oauth_callback_port is set
Tool approvaldefault_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 listsenabled_tools and disabled_tools, with the deny list applied after the allow list
Default waits10 seconds for a server to start and 60 seconds per tool call
Admin controlAn 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
PluginsOne 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 scopeWhat Zoho's reference says it coversWhat the Ryze AI tools use it for
ZohoCRM.modules.ALLRead, create, update and delete records in every module, Leads, Contacts, Accounts, Deals, Tasks, Products, Quotes, Invoices and custom modules among themRecord reads, COQL results, writes and deletes
ZohoCRM.settings.ALLEvery 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 itzoho__read looks up modules and fields. No tool changes settings
ZohoCRM.users.READGet user data, with no changes to userszoho__read lists users, for example to put names on owner IDs
ZohoCRM.org.READGet organization data, with no changes to the organizationzoho__read can fetch the organization details
ZohoCRM.coql.READRun COQL queries. Zoho requires a modules scope next to it, and a fields scope to read field metadatazoho__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.

ToolTypeWhat it does
zoho__readReadSends a GET request to any Zoho CRM API resource, such as module records, a single record, module settings, fields or users.
zoho__queryReadRuns a COQL query, a SQL-like select over CRM modules, returning up to 2,000 rows per call.
zoho__writeWriteCreates, updates or upserts Zoho CRM records, up to 100 records per call.
zoho__deleteDeleteDeletes 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.

LimitWhat Zoho documentsSource
Credits, Free edition5,000 per rolling 24 hours, with 5 calls at onceZoho API limits
Credits, Standard and Starter50,000 plus 250 per user license and any add-on credits, capped at 100,000, with 10 calls at onceZoho API limits
Credits, Professional50,000 plus 500 per user license and add-ons, capped at 3,000,000, with 15 calls at onceZoho API limits
Credits, Enterprise and Zoho One50,000 plus 1,000 per user license and add-ons, capped at 5,000,000, with 20 calls at onceZoho API limits
Credits, Ultimate and CRM Plus50,000 plus 2,000 per user license and add-ons, with no cap and 25 calls at onceZoho API limits
Heavy calls at once10 in every edition for COQL queries, writes of more than 10 records, Convert Lead and a few other calls. Going over returns TOO_MANY_REQUESTSZoho API limits
Calls per minuteNo cap. Only credits and concurrent calls are limitedZoho API limits
COQL credits1 for LIMIT 1 to 200, 2 for 201 to 1,000, 3 for 1,001 to 2,000Zoho API limits
Write credits1 for every 10 records inserted, updated or upserted, so at most 10 per callZoho API limits
Other credit costsMass delete by ID: 1 per 100 records. Convert Lead: 5. Record count of a module: 50Zoho API limits
Credits leftResponses 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 DashboardZoho API limits
COQL rowsLIMIT 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 APICOQL overview
COQL query size500 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 wellCOQL limitations
Get Records200 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 recordsGet records
Records per write100 per insert, update or upsert call. A batch where some records fail answers HTTP 207 with one result per recordInsert records
Automation on writesUnless the call sends an empty trigger list, inserts and upserts run the module's workflows, approvals and blueprintsUpsert records
Records per delete100 per call. Workflow rules run on deletion unless the call turns them offDelete records
Recycle binDeleted records can be restored for 60 days, then Zoho removes them for goodZoho recycle bin
Zoho access tokenValid for 1 hour. The refresh token lasts until the user revokes itToken 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.

JobAsk CodexToolWorks on the default connection
One record in fullShow the deal whose ID I paste, with its subform rows.zoho__readYes. Zoho returns subforms only when a single record is fetched
Move deals to a new stageFind the deals I describe, list them for me, and after I confirm, set their Stage to the value I give.zoho__query, then zoho__writeYes, up to 100 records per call
Deals with account fieldsIn one COQL query, return each open deal together with fields from its linked account.zoho__queryYes, within Zoho's limit on joins
Amount by stageTotal the Amount of open deals for each Stage.zoho__queryYes
Field API namesList the fields of the Leads module with their API names before you write the query.zoho__readYes
Owner namesList the CRM users so the owner IDs in that report get names.zoho__readYes
Import new leadsCreate these leads in batches of 100 and give me the status of every record.zoho__writeYes. It changes live data
Merge a contact listUpsert these contacts, matching on Email, so known ones update and new ones are added.zoho__writeYes. Email is Zoho's default duplicate check for contacts
Clean up test dataDelete the test leads whose IDs I paste.zoho__deleteYes. They stay restorable in the recycle bin for 60 days
Add a custom fieldAdd a Renewal_Date field to the Deals module.NoneNo. 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.

WayRuns whereSetup in CodexWhat it reaches in Zoho CRMPrice
Ryze AI connector (the main way)Hosted by Ryze AI, one URL for every user. The same URL also works in Claude, ChatGPT and Cursorcodex 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 runs4 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 onlyPaid Ads at $89 per month with a 7-day free trial. Adding the connector is free
ComposioHostedComposio'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 own113 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 usersFree: $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 MCPHostedZapier'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 CodexThe 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 list2 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

DateWhat happened
July 17, 2025Zoho announced its own MCP server in a press release, with more than 15 Zoho tools in early access.
September 23, 2025The 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, 2025Codex CLI 0.44.0 added Streamable HTTP MCP servers, the transport the Codex steps on this page use.
October 6, 2025Codex CLI 0.45.0 brought experimental OAuth sign-in for MCP servers.
March 9, 2026Zoho published the launch post for Zoho MCP, its service for building MCP servers.
March 2026The Zoho CRM connector made by Zoho appeared in Claude's connector directory. The listing gives the month only.
April 6, 2026Zoho announced MCP servers built into Zoho CRM, rolling out to data centers in phases.
July 9, 2026Codex became part of the ChatGPT desktop app in release 26.707, which is why the desktop steps name ChatGPT.
September 1, 2026Codex CLI 0.152.0 added output_token_limit for single MCP tools.
October 7, 2026Codex CLI 0.161.0 added /mcp login <name> for signing in from a running session.
October 2026The latest Zoho CRM release in the Zoho MCP changelog added 95 tools and removed 85.
November 13, 2026Codex 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, 2026Zoho'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 runWhat came back
A request to https://connector.get-ryze.ai/mcp with no sign-inHTTP 401 with a WWW-Authenticate header pointing to the sign-in details.
The two discovery files on the connector's hostBoth 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.

Connect Zoho CRM to Codex

Connect Zoho CRM once and use the same URL in other MCP clients. Paid Ads is $89 per month with a 7-day free trial; annual billing takes 30% off the first year.

Zoho CRM MCP server

Need help? Read the Ryze AI Zoho CRM guide or email Ryze AI support.