By Ira Bodnar, Ryze AI · Updated · Connector tested November 19, 2026
Quick answer
The main way to connect Codex to ClickUp is the Ryze AI connector. Paste a ClickUp personal API token into the ClickUp card in Ryze AI and pick one ClickUp Workspace, then run codex mcp add ryze --url https://connector.get-ryze.ai/mcp followed by codex mcp login ryze. The one entry serves the Codex CLI, the ChatGPT desktop app and the IDE extension, and Codex never holds the ClickUp token.
- In ClickUp open Settings > Apps > API Token and click Generate
- In Ryze AI open Integrations, click Connect on the ClickUp card, paste the pk_ token and choose the Workspace
- In Codex run codex mcp add ryze --url https://connector.get-ryze.ai/mcp
- Run codex mcp login ryze, sign in on the Ryze AI page and click Allow connection
Codex to ClickUp at a glance
| Fact | Detail |
|---|---|
| Main way to connect | The Ryze AI connector, a hosted MCP server that Codex reaches as a Streamable HTTP address |
| Server address | https://connector.get-ryze.ai/mcp |
| Sign-in | A ClickUp personal API token (pk_) saved in Ryze AI once, then the Ryze AI page that codex mcp login ryze opens. A Ryze AI API key read from an environment variable also works |
| ClickUp tools | 3: clickup__read, clickup__write and clickup__delete |
| Can Codex change ClickUp | Yes. clickup__write creates and updates tasks and adds comments, and clickup__delete removes a task or comment. Approval settings in config.toml make Codex ask first |
| Same chat, other data | The same address serves the other platforms connected in your Ryze AI workspace |
| Codex plan | Included in ChatGPT Free, Go, Plus, Pro, Business, Edu and Enterprise. Free and Go get the desktop app only, subject to rollout |
| ClickUp access you need | Any ClickUp user who can open Settings > Apps and generate a personal token. The agent sees what that user sees |
| Ryze AI price | Paid Ads is $89 per month with a 7-day free trial. Adding the connector costs nothing |
| ClickUp's own option for Codex | ClickUp's MCP server at https://mcp.clickup.com/mcp, OAuth only, on all ClickUp plans. A community server documents a Codex setup |
| Last tested | November 19, 2026: the connector's reply to a request without sign-in and its discovery file. No ClickUp call and no step inside Codex was run |
Before you start
- An OpenAI plan that includes Codex. OpenAI lists Codex in ChatGPT Free, Go, Plus, Pro, Business, Edu and Enterprise. Its pricing page shows Free and Go with Codex in the desktop app only, subject to rollout, so on those plans use the desktop app steps. Plus and higher add the CLI and the IDE extension. Codex also runs with an OpenAI API key in the CLI, SDK or IDE extension, billed at API pricing. OpenAI's MCP page names no extra plan for adding a server.
- A ClickUp personal API token. In ClickUp open Settings > Apps, find API Token and click Generate. The token starts with pk_, and ClickUp says personal tokens never expire. The Ryze AI agent acts as the token owner, so generate it from the ClickUp login whose reach you are comfortable sharing.
- An active Ryze AI plan or trial. Paid Ads is $89 per month and comes with a 7-day free trial. SEO Starter is $129 per month with a 3-day free trial, and Agency is $279 per month. The connector is free to add, yet the ClickUp tools only answer while a plan or trial is active.
How to connect Codex to ClickUp with the CLI
Two steps happen in ClickUp and Ryze AI, three in Codex. The server URL is the same for every user.
Generate a ClickUp personal API token
In ClickUp open Settings > Apps, find API Token and click Generate. Copy the token, which starts with pk_.
Connect ClickUp in Ryze AI
Sign in to Ryze AI or create an account, open Integrations and click Connect on the ClickUp card. Paste the token into Personal API token and click Continue, then choose the Workspace the agent reads and writes and click Save. With only one Workspace, Ryze AI picks it for you.
Add the Ryze AI server to Codex
Run codex mcp add ryze --url https://connector.get-ryze.ai/mcp. In the ChatGPT desktop app or the IDE extension, use the MCP servers settings instead (see the sections below). All three share one MCP configuration.
Sign in and allow the connection
Run codex mcp login ryze, sign in on the Ryze AI page and click Allow connection. Without a local browser, add --no-browser, open the printed URL and paste the full redirect URL back into the terminal.
Check the server and ask your first question
Run codex mcp list, or type /mcp inside the Codex TUI, to see the ryze server. If the connector was added before ClickUp was connected, remove and re-add it first. Then ask: List the tasks assigned to me in ClickUp that are past their due date.
codex mcp add ryze --url https://connector.get-ryze.ai/mcpcodex mcp login ryzeIn a terminal this is the shortest route. codex mcp add writes the ryze entry into ~/.codex/config.toml, and codex mcp login opens the Ryze AI sign-in in your browser. Check the result with codex mcp list, or with /mcp inside the codex TUI. The ClickUp token stays in Ryze AI.
The Ryze AI help article for ClickUp covers the ClickUp side of the connection, and the Ryze AI agent API help page covers API keys.
Sources: OpenAI Codex MCP docs, Codex CLI command reference, Ryze AI ClickUp guide. Checked November 19, 2026.
ChatGPT desktop app and IDE extension
The ChatGPT desktop app and the IDE extension read the same MCP configuration as the CLI, so a server added in one place appears in the other two. Both take a form instead of commands, followed by a restart.
ChatGPT desktop app (Codex)
- Open Settings, then select MCP servers.
- Select Add server, enter the name ryze, choose Streamable HTTP and enter https://connector.get-ryze.ai/mcp.
- Save, then select Restart.
- Select Authenticate next to ryze and complete the Ryze AI sign-in. Type /mcp in the composer to view connected servers.
Codex IDE extension
- Open the gear menu, then select MCP servers.
- Select Add server, enter the name ryze, choose Streamable HTTP and enter https://connector.get-ryze.ai/mcp.
- Save, then select Restart extension.
- Select Authenticate and complete the Ryze AI sign-in.
config.toml
To keep the server in a file, edit ~/.codex/config.toml, or a project .codex/config.toml in a trusted project. OAuth is the default for an HTTP server; run codex mcp login ryze to sign in. Long task lists can be big, so the example raises the per-call timeout and gives the read tool an output budget.
[mcp_servers.ryze]
url = "https://connector.get-ryze.ai/mcp"
# Optional: raise the defaults (10 and 60 seconds)
startup_timeout_sec = 20
tool_timeout_sec = 120
[mcp_servers.ryze.tools.clickup__read]
output_token_limit = 20000For a Ryze AI API key instead of OAuth, add bearer_token_env_var = "RYZE_API_KEY" to the same table and set that environment variable to your rk_live_ key. Do not paste the key into the file. The Ryze AI key is separate from the ClickUp pk_ token.
Codex cloud tasks are left out on purpose. OpenAI's MCP page does not cover them, so this guide makes no claim that the connector works there. The Ryze AI connector was also not run end to end inside Codex for this guide.
What OpenAI documents about MCP in Codex
| Topic | What OpenAI's documentation says |
|---|---|
| Surfaces that take a server | Codex CLI, the ChatGPT desktop app and the Codex IDE extension, which share one MCP configuration |
| Settings file | ~/.codex/config.toml, which codex mcp add edits for you. A project .codex/config.toml is read only after you trust that project |
| Transports | STDIO, a local process started by a command, and Streamable HTTP, a server reached at an address |
| Sign-in to a remote server | OAuth by default, through Client ID Metadata Documents or dynamic client registration. Other options: a bearer token read from an environment variable or custom headers |
| Approval of tool calls | default_tools_approval_mode per server: auto, prompt, writes or approve. The writes value prompts for any tool not marked read-only. tools.<tool>.approval_mode overrides one tool |
| Allow and deny lists | enabled_tools and disabled_tools per server |
| Where servers are managed | codex mcp list, get, remove, login and logout in a shell; /mcp inside a session; Settings > MCP servers in the desktop app; the gear menu > MCP servers in the IDE extension |
| Admin control | An approved mcp_servers list in requirements.toml, matched on the server name and, for a remote server, its URL |
| Plan | The MCP page sets no plan condition for adding a server. The CLI and the IDE extension come with Plus and higher or an OpenAI API key; Free and Go have only the desktop app, subject to rollout |
Sources: OpenAI Codex MCP docs, Codex CLI command reference, Codex pricing, Codex managed configuration. Checked November 19, 2026.
Other clients
The same URL works in other MCP clients. ClickUp is connected once in Ryze AI, so nothing changes on the ClickUp side.
Claude and ChatGPT
In Claude, add https://connector.get-ryze.ai/mcp as a custom connector under Customize, Connectors. In ChatGPT, add the same URL as an app under Settings > Apps. Pick the workspaces and start a new chat. The Claude guide for ClickUp and the ChatGPT guide for ClickUp have every click.
Claude Code and Cursor
The Claude Code guide for ClickUp and the Cursor guide for ClickUp cover those two. For Cursor the entry in .cursor/mcp.json is:
{ "mcpServers": { "ryze": { "url": "https://connector.get-ryze.ai/mcp" } } }Source for the ChatGPT steps: OpenAI's page on connecting a server to ChatGPT. Checked November 19, 2026.
ClickUp access and the token
ClickUp has no scope picker for a personal token, so three things decide what Codex can see and change.
- Whose access
- The ClickUp user who generated the token. Ryze AI says the agent acts as the token owner and sees and edits what that user can.
- Which Workspace
- The one Workspace you pick on the ClickUp card. One connection covers one ClickUp Workspace, and the Ryze AI help center does not list ClickUp among the platforms that support several accounts.
- What Codex asks first
- That depends on config.toml. With default_tools_approval_mode set to writes, Codex prompts for tools not marked read-only, and disabled_tools can hide the write and delete tools.
What the connection covers
ClickUp's authentication page lists no granular permissions for a personal token and says personal tokens never expire. The table lists what Ryze AI documents for the connection.
| Access | What it covers | Through which tool |
|---|---|---|
| Read | Workspaces, Spaces, Folders, Lists, tasks, comments, members, custom fields and Docs | clickup__read |
| Create and update | Creating a task, updating a task and adding a comment | clickup__write |
| Delete | Deleting a task or a comment by path | clickup__delete |
Not included: a second Workspace on the same connection, and writes to Docs. Ryze AI's help page documents writes for tasks and comments only, so this guide claims only task creation, task updates and comments as writes. The token also reaches only what its owner can reach in ClickUp, so a private List the owner cannot open stays closed to Codex.
Sources: ClickUp authentication, Ryze AI ClickUp guide. Checked November 19, 2026.
Removing access
In Codex, codex mcp logout ryze deletes the stored sign-in and codex mcp remove ryze deletes the entry. To pause the server and keep its settings, set enabled = false in the [mcp_servers.ryze] table. On the ClickUp side, clicking Regenerate under Settings > Apps > API Token replaces the token. The Ryze AI notes used for this guide give no disconnect step for the ClickUp card, so none is described here.
What Codex can do in ClickUp
The Ryze AI connector exposes 3 ClickUp tools: 1 read, 1 write and 1 delete. The list comes from Ryze AI's integration manifest and has not yet been seen live in a connected workspace. Codex calls them through the ryze server, against the one Workspace you picked.
| Tool | Type | What it does |
|---|---|---|
| clickup__read | Read | Reads ClickUp data with GET requests: Workspaces, Spaces, Folders, Lists, tasks, comments, members, custom fields and Docs. |
| clickup__write | Write | Creates or updates ClickUp objects with POST or PUT, such as creating a task, adding a comment or updating a task. |
| clickup__delete | Delete | Deletes a ClickUp object by path, such as a task or a comment. |
The tools need an active Ryze AI plan or free trial; without one, the connector can only list workspaces and connect platforms.
Approvals in Codex
Codex lets you set approvals per server. In config.toml, default_tools_approval_mode can be auto, prompt, writes or approve; writes prompts for tools that are not marked read-only. Per-tool overrides use tools.<tool>.approval_mode, and enabled_tools and disabled_tools work as allow and deny lists. For ClickUp, a deny list on clickup__write and clickup__delete keeps the server read-only in Codex. The Ryze AI chat itself starts on Skip all approvals; pick Approve write & delete or Manual approve in its Tool approvals setting if you use it too. Scheduled tasks in Ryze AI run without an approval step.
[mcp_servers.ryze]
url = "https://connector.get-ryze.ai/mcp"
default_tools_approval_mode = "writes"
disabled_tools = ["clickup__delete"]ClickUp and Codex limits in numbers
| Limit | Figures |
|---|---|
| ClickUp API requests per minute, Free Forever, Unlimited and Business | 100 per token |
| ClickUp API requests per minute, Business Plus | 1,000 per token |
| ClickUp API requests per minute, Enterprise and Enterprise Plus | 10,000 per token |
| When the ClickUp limit is exceeded | HTTP 429 with X-RateLimit-Limit, X-RateLimit-Remaining and X-RateLimit-Reset headers |
| Ryze AI notes on the ClickUp limit | 100 requests per minute per token |
| ClickUp Workspaces per Ryze AI connection | 1 |
| Codex waiting time | 10 seconds to start a server and 60 seconds per tool call by default; startup_timeout_sec and tool_timeout_sec raise them |
| Codex output budget | tools.<tool>.output_token_limit sets one tool's output budget |
| ClickUp's own MCP server, per connection | 1,000 requests per minute, shown for comparison |
| ClickUp's own MCP server, per day | Without the Everything AI add-on: 100 on Free Forever, 300 on Core/Unlimited, 1,000 on Business, 2,500 on Business Plus, 5,000 on Enterprise, 25,000 on Enterprise Plus |
ClickUp's rate limit page names the plan Unlimited while its MCP page lists Core/Unlimited; this guide repeats each page's wording. The daily MCP limits belong to ClickUp's own server. Whether the Ryze AI connector's calls count against them is not stated by either vendor.
Sources: ClickUp rate limits, ClickUp authentication, ClickUp MCP connection page, OpenAI Codex MCP docs, Codex auto-review. Checked November 19, 2026.
First 3 prompts to run
Name the Space, Folder or List when you can, and ask for the fields you want back. Each answer comes from your own Workspace, so this page describes what comes back instead of showing sample task data.
1. Find overdue tasks
In my ClickUp Workspace, list the tasks assigned to me that are past their due date. Show each task name, its List and its due date.
Tools used: clickup__read
What comes back: A list of task names with their Lists and due dates, printed in the Codex session. Nothing is changed.
2. Summarize a comment thread
Read the comments on the ClickUp task I name next and summarize who asked for what, in the order it happened.
Tools used: clickup__read
What comes back: A written summary of that task's comments, built from what the read tool returns.
3. Create a task and add a comment
Create a task called Fix signup redirect in the List named Engineering, then add a comment on it that says the repro steps are in the pull request.
Tools used: clickup__write
What comes back: A new task in that List and a comment on it. With default_tools_approval_mode set to writes, Codex stops and asks before the call.
Replace the names with your own. Deleting has its own tool, so name the task and say that you want it deleted. Add clickup__delete to disabled_tools if Codex should never do it.
10 jobs to hand to Codex
Ten jobs to hand to Codex in ClickUp, with the tool each one calls. None was run for this guide, since no ClickUp Workspace was connected. A Yes means a Ryze AI tool covers the job according to Ryze AI's notes. The No row is a job the documented tools do not cover.
| Job | Ask Codex | Tool | Default connection |
|---|---|---|---|
| Workspace map | List my Spaces, Folders and Lists. | clickup__read | Yes |
| Overdue tasks | Which tasks assigned to me are past their due date? | clickup__read | Yes |
| Task detail | Show the description, assignees and custom fields of the task I name. | clickup__read | Yes |
| Bug context | Read the ClickUp task for this bug and tell me what it asks for before I change the code. | clickup__read | Yes |
| Team list | List the members of the Workspace. | clickup__read | Yes |
| Read a Doc | Find the Doc I name and summarize it. | clickup__read | Yes |
| Create a task | Create a task with this name in this List. | clickup__write | Yes, and the writes approval mode makes Codex ask first |
| Post a comment | Add a comment to the task I name saying the fix is in review. | clickup__write | Yes, and the writes approval mode makes Codex ask first |
| Remove a task | Delete the task I name. | clickup__delete | Yes, only when you ask, and keep it in disabled_tools until then |
| Edit a Doc | Rewrite this Doc. | none | No. Ryze AI documents Docs as read only |
3 ways to connect Codex to ClickUp
Three ways reach ClickUp from Codex, counting only those whose makers name Codex or accept any MCP client. This guide uses the first, the Ryze AI connector, as the main way: ClickUp is linked once with a token in Ryze AI, one codex mcp add command covers all three Codex surfaces, and reads, writes and deletes stay in separate tools. The other two were read on their own pages on November 19, 2026, and neither was installed for this guide.
| Way | Runs where | Setup in Codex | What it reaches in ClickUp | Price |
|---|---|---|---|---|
| Ryze AI connector (the main way) | Hosted by Ryze AI, one address for every user | codex mcp add ryze --url https://connector.get-ryze.ai/mcp and codex mcp login ryze, or Add server in the desktop app or IDE extension | 3 tools: read Workspaces, Spaces, Folders, Lists, tasks, comments, members, custom fields and Docs; create and update tasks and add comments; delete a task or comment. One Workspace per connection | Paid Ads is $89 per month with a 7-day free trial. The connector is free to add |
| ClickUp's MCP server | Hosted by ClickUp at https://mcp.clickup.com/mcp | ClickUp's page gives no Codex command. OpenAI's syntax, codex mcp add clickup --url https://mcp.clickup.com/mcp followed by codex mcp login clickup, should apply, but it was not run. ClickUp says OAuth only, so a personal API token cannot be used | ClickUp's tools page lists categories such as search, tasks, comments, time tracking, Docs, chat and reminders, with every tool acting as the signed-in user. Its FAQ says no deletion tools were added as a safety measure, while the tools page lists a delete task tool | ClickUp says it is available on all plans, with daily call limits by plan |
| taazkareem/clickup-mcp-server, community | Hosted at https://clickup-mcp.taazkareem.com/mcp, or self-hosted | Its README has a Codex section with config.toml settings for the remote and local options, and sends an X-License-Key header | The README counts 150 tools | Paid license: $9 per month or $59 per year, per its README |
ClickUp options that do not fit Codex
- A personal API token on ClickUp's own server. ClickUp's MCP page says you cannot authenticate with your own API keys or access tokens. The Ryze AI connector is the route that uses a personal token, because Ryze AI holds it and Codex signs in to Ryze AI.
- ClickUp's connector in ChatGPT or Claude directories. Those listings are for the chat apps. This guide did not check whether they reach Codex, so it makes no claim either way.
- Codex cloud tasks. OpenAI's MCP page does not cover them, so no route here is claimed to work there.
Which one to pick
Ryze AI is the best way to connect Codex to ClickUp when you want one codex mcp add command for the CLI, the desktop app and the IDE extension, ClickUp linked with a token you control, and deletes kept in their own tool, with one caveat: it has 3 tools, one ClickUp Workspace per connection, and Docs are read only. ClickUp's own server needs no Ryze AI plan, signs in with OAuth and lists more areas, including time tracking, chat and reminders, so it is the better fit when Codex is your only assistant and you need those. The community server suits a team that wants a much larger tool count and accepts a paid license.
Sources: ClickUp MCP connection page, ClickUp MCP tools, taazkareem/clickup-mcp-server, Codex plugins, OpenAI Codex pricing, Ryze AI ClickUp guide. Checked November 19, 2026.
Sources for the options that do not fit: ClickUp MCP connection page, OpenAI Codex MCP docs. Checked November 19, 2026.
Codex, ClickUp and MCP: dates that matter
| Date | What happened |
|---|---|
| October 3, 2025 | Codex CLI 0.44.0 added support for Streamable HTTP MCP servers, the transport the Ryze AI connector uses. |
| October 6, 2025 | Codex became generally available, and Codex CLI 0.45.0 brought experimental OAuth sign-in for MCP servers. |
| July 9, 2026 | Codex became part of the ChatGPT desktop app on macOS and Windows. Codex CLI 0.144.0 added a writes app-approval mode that allows declared read-only actions and prompts for writes. |
| October 7, 2026 | Codex CLI 0.161.0 added /mcp login <name> for signing in from a running session. |
| November 19, 2026 | ClickUp's authentication page says personal tokens never expire, its rate limit page lists 100, 1,000 and 10,000 requests per minute by plan, and its MCP page says the server is available on all plans and supports OAuth only. ClickUp's pages give no launch date for its MCP server, so none is stated here. |
Sources: Codex changelog, Codex CLI 0.44.0 and 0.45.0 release notes, ClickUp authentication, ClickUp rate limits, ClickUp MCP connection page. Checked November 19, 2026.
How this guide was tested
For this guide the Ryze AI connector was checked from the outside on November 19, 2026. No ClickUp Workspace is connected in the test workspaces, so the record is short.
| What was run | What came back |
|---|---|
| The address with no sign-in, November 19 | https://connector.get-ryze.ai/mcp returned HTTP 401 with a WWW-Authenticate header that points to its protected resource metadata. Per OpenAI's MCP page, this first challenge is where Codex looks for the scopes to request. |
| The sign-in details, November 19 | The authorization server file loaded. It lists the authorize, token and register endpoints, the authorization code and refresh token grants, PKCE with the S256 and plain methods, and the scopes mcp:read and mcp:write. |
| ClickUp's MCP address with no sign-in, November 19 | https://mcp.clickup.com/mcp returned HTTP 401. |
| The ClickUp tool list | Not seen live. The three tool names come from Ryze AI's integration manifest, because no workspace has ClickUp connected. |
| Calls to ClickUp | None. No tool was called and no ClickUp response is quoted on this page. |
Not run for this page: the setup steps inside Codex. Nobody ran codex mcp add, codex mcp login or a tool call from the CLI, the ChatGPT desktop app or the IDE extension, so those steps follow OpenAI's Codex documentation as read on November 14, 2026, and the Ryze AI help center. No ClickUp token was pasted into Ryze AI, so no error message from a ClickUp call is quoted here.
Codex and ClickUp errors and fixes
- ClickUp tools do not appear in Codex
- If the connector was added before ClickUp was connected in Ryze AI, remove the ryze server with codex mcp remove ryze, add it again, sign in and start a new session.
- codex mcp login opens no 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 on start or on a call
- Codex waits 10 seconds to start a server and 60 seconds per tool call by default. Raise startup_timeout_sec or tool_timeout_sec in the [mcp_servers.ryze] table.
- Ryze AI rejects the token
- Paste the full pk_ token from Settings > Apps > API Token. If it was regenerated since, the old one no longer works, so copy the new one.
- Codex sees the wrong Workspace
- Each connection covers one ClickUp Workspace. Reconnect the ClickUp card in Ryze AI and choose the Workspace you want.
- A task or List is missing
- The agent has the token owner's permissions only. A List or Space that user cannot open is not visible to Codex.
- A Doc edit is refused
- Ryze AI documents Docs as read only. Ask Codex to draft the text, and paste it into ClickUp yourself.
- The ryze table in a project config.toml is ignored
- Codex reads a project's .codex/config.toml only in a trusted project. Trust the project, or move the table to ~/.codex/config.toml.
- Output is cut off
- Set tools.clickup__read.output_token_limit in config.toml to give the read tool a larger output budget, or ask for fewer fields and a narrower List.
- Calls fail after heavy use
- ClickUp answers HTTP 429 when a token passes its plan's per-minute limit. Wait for the time in X-RateLimit-Reset, or ask for fewer, narrower requests.
- A tool replies that a subscription is required
- The ClickUp tools need an active Ryze AI plan or free trial. Start the trial, then retry.
- No CLI or IDE extension on a Free or Go plan
- OpenAI lists Codex on those plans in the desktop app only, subject to rollout. Use the desktop app steps.
Sources: ClickUp rate limits, OpenAI Codex MCP docs, Codex changelog. Checked November 19, 2026.
Terms on this page
- MCP
- The Model Context Protocol, which Codex uses to call tools on outside servers such as the Ryze AI connector.
- Streamable HTTP
- The transport Codex uses for a server it reaches at an address. Its other transport, STDIO, starts a local process.
- config.toml
- The Codex settings file at ~/.codex/config.toml, read by the CLI, the ChatGPT desktop app and the IDE extension alike.
- Personal API token
- A ClickUp credential that starts with pk_ and acts as the user who generated it. ClickUp says it never expires.
- Workspace
- ClickUp's top-level container for Spaces, Folders, Lists and tasks. A Ryze AI workspace is a different thing: the Ryze AI account area that Codex is allowed into.
- List
- The ClickUp container that holds tasks, inside a Space or a Folder.
- Rate limit
- ClickUp's cap on requests per minute for one token, set by the Workspace plan.
Sources: OpenAI Codex MCP docs, ClickUp authentication, ClickUp rate limits. Checked November 19, 2026.
Frequently asked questions
How do I connect Codex to ClickUp?
Generate a personal API token in ClickUp under Settings > Apps > API Token, then in Ryze AI open Integrations, click Connect on the ClickUp card, paste the token and choose a Workspace. Run codex mcp add ryze --url https://connector.get-ryze.ai/mcp, then codex mcp login ryze, sign in on the Ryze AI page and click Allow connection.
Does ClickUp have its own MCP server for Codex?
Yes. ClickUp's MCP server is at https://mcp.clickup.com/mcp, supports OAuth only and is available on all ClickUp plans. ClickUp's page names no Codex command, so the codex mcp add syntax from OpenAI's docs is the likely route, but it was not run for this guide.
Which ClickUp connector should I use with Codex?
Pick the Ryze AI connector when you want one entry for the CLI, the desktop app and the IDE extension next to your other Ryze AI platforms. It has 3 tools and one Workspace and needs a Ryze AI plan. ClickUp's own server needs no Ryze AI plan and lists more areas, such as time tracking and chat.
Can I run the Ryze AI connector and ClickUp's own server in Codex at the same time?
Yes. Each one is its own [mcp_servers.<name>] table in config.toml, for example ryze and clickup. OpenAI advises turning off servers you do not need, because each server adds context to your messages.
Which Codex plan do I need?
OpenAI lists Codex in ChatGPT Free, Go, Plus, Pro, Business, Edu and Enterprise. Free and Go get Codex in the desktop app only, subject to rollout. Plus and higher add the CLI and the IDE extension. OpenAI's MCP page names no plan condition for adding a server.
Does Codex sign in to ClickUp directly?
Not with the Ryze AI connector. Codex signs in to Ryze AI through OAuth or a Ryze AI API key, and Ryze AI uses the ClickUp token you saved, so Codex never holds it. With ClickUp's own server, Codex signs in to ClickUp through OAuth instead.
Which tools does Codex get for ClickUp?
Three: clickup__read for Workspaces, Spaces, Folders, Lists, tasks, comments, members, custom fields and Docs, clickup__write to create and update tasks and add comments, and clickup__delete for a task or comment. Ryze AI's notes say the tool list has not yet been seen live in a connected workspace.
Can Codex edit or delete ClickUp tasks?
Yes, when you ask. Set default_tools_approval_mode to writes in config.toml to make Codex ask first, or list clickup__write and clickup__delete under disabled_tools to keep the server read-only.
Can Codex edit a ClickUp Doc?
Not through the Ryze AI connector. Ryze AI documents Docs as read only, and documented writes cover tasks and comments.
What ClickUp permissions does the connection use?
A personal API token that starts with pk_. The agent acts as the token owner and sees and edits what that user can. ClickUp documents no granular scopes for personal tokens.
What is the ClickUp API rate limit?
ClickUp documents 100 requests per minute per token on Free Forever, Unlimited and Business, 1,000 on Business Plus and 10,000 on Enterprise and Enterprise Plus. Past the limit the ClickUp API returns HTTP 429.
Can I use my personal API token in ClickUp's own MCP server?
No. ClickUp's MCP page says you cannot authenticate with your own API keys or access tokens and that only OAuth is supported. The Ryze AI connector uses a personal token that you paste into Ryze AI.
Can I connect more than one ClickUp Workspace?
Not on one connection. Ryze AI says one connection covers one ClickUp Workspace, and the help center does not list ClickUp among the platforms that support several accounts.
Does this work in Codex cloud tasks?
This page does not claim it does. OpenAI's MCP page covers the CLI, the desktop app and the IDE extension, and the connector was not tested in Codex cloud.
Do I need to configure the CLI, the app and the IDE extension separately?
No. The ChatGPT desktop app, the Codex CLI and the IDE extension share one MCP configuration. Restart the app or the extension after you add the server.
How much does it cost to connect Codex to ClickUp?
Adding the connector costs nothing, but the ClickUp 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. Codex itself is billed under your OpenAI plan or API pricing.