Skip to content

Connect Codex to ClickUp

Connect Codex to ClickUp in 3 steps: 1. Sign in to ApexGenius and connect ClickUp. 2. Add the ApexGenius plugin. 3. Start using ClickUp in Codex. Start in Plugins in the ChatGPT desktop app and authorize your connection.

1,000 free credits · No card required

How to connect ClickUp to Codex

  1. 1Sign in to ApexGenius and connect ClickUp
  2. 2Add the ApexGenius plugin to Codex
  3. 3Start using ClickUp in Codex
  1. 1ClickUp

    Connect ClickUp to ApexGenius

    Connect ClickUp

    ClickUp opens its own sign-in. Sign in and allow ApexGenius.

  2. 2ApexGenius

    Connect ApexGenius to Codex

    Choose Codex

    Back on Start, pick Codex and copy the prompt.

  3. 3ApexGenius

     

    Approve access

    ApexGenius opens its approval page. Review the access, then approve.

Add the ApexGenius plugin to Codex

Codex stores MCP servers in ~/.codex/config.toml. The ChatGPT desktop app, the Codex CLI and the IDE extension share that file, so one setup covers all three on the same machine.

  1. In the ChatGPT desktop app, open Plugins and select an ApexGenius plugin shared with you or one you created. Connect it and authorize the app connections you intend to use.
  2. No plugin? Open Settings, then MCP servers, then Add server. Name it ApexGenius, choose Streamable HTTP and paste the MCP address.
  3. Save, select Restart, then Authenticate, and sign in to ApexGenius in your browser.
  4. Start a new Codex task.

The MCP address

https://server.autom8.pro/mcp

Check it. In the composer, type /mcp to view the connected servers.

Steps follow OpenAI documentation, Model Context Protocol for ChatGPT and Codex (opens in a new tab), read November 12, 2026.

Then ask Codex

Show the spaces, folders and lists in my connected ClickUp workspace. Do not create or change anything.

Start free
Written setup, step by stepShow

Before you start

  • An account with permission to use the ClickUp resources you intend to connect.

1. Connect ClickUp to ApexGenius

  1. Open ClickUp in Connections. Choose Connect, or Add connection when offered. Give the connection a name if prompted. If Gateway setup pending appears, contact ApexGenius support before continuing.
  2. Choose the account and review access. Sign in to ClickUp in the browser and choose the workspace to allow if ClickUp asks. ClickUp uses browser authorization; no API key is pasted into ApexGenius.
    The full ClickUp login page for the ClickUp MCP Service, with a red box around the login form.
    Connect opens ClickUp's login for the ClickUp MCP Service. Log in with SSO or your work email, then allow ApexGenius.Open full-size image (opens in a new tab)
  3. Review the connected account and resources. Confirm the connected ClickUp account and workspace. Open Tools to review the task, list, doc, chat and time tools. ClickUp limits MCP calls per day by plan.
  4. Check the connection. Use Test connection or Check again and read the reported status. Add an AI agent from the AI agents page, choose Read only for the first test, and try the question below.
Connect ClickUp →

2. Connect ApexGenius to Codex

The steps are above, under Add the ApexGenius plugin to Codex. These notes apply to Codex only.

  • From the terminal. The commands are under Manual setup for developers. codex mcp list shows the configured servers, and codex mcp login apexgenius runs the sign-in.
  • Without a local browser. Run codex mcp login apexgenius --no-browser, open the printed authorization URL on another machine, sign in, and paste the full redirect URL back into the terminal.
  • Asking before writes. In config.toml, default_tools_approval_mode = "writes" on the apexgenius server makes Codex ask before any tool that is not marked read-only.
  • ChatGPT on the web. ChatGPT on the web does not read local Codex configuration. It uses plugins.
  • Access. When ApexGenius asks what Codex may use, choose Read only for the first test, or Custom to limit it to the tools you need.

Watch the setup

Follow each step at your own pace.

Codex desktop app with Plugins selected and ApexGenius listed under Available to your account.
Open Codex in the ChatGPT desktop app, then Plugins, and find ApexGenius.Open full-size image (opens in a new tab)

The walkthrough uses the original ChatGPT web plugin captures. After connecting, open Codex in the desktop app and start a new task with ApexGenius. A ChatGPT web connection does not verify Codex access.

A public ApexGenius plugin listing is not verified. Use a plugin shared with you or one you created, subject to your account and workspace policy.

Create a personal plugin

Where Developer mode is available, open ChatGPT Settings, then Security and login, and enable it. In Plugins, select the plus button, enter ApexGenius and a description, then add this URL under Connection. Create the connection, complete OAuth, and review the tools. Return to Codex in the desktop app and start a new task with the plugin enabled.

https://server.autom8.pro/mcp
OpenAI custom connection guide (opens in a new tab)
No plugin available? Use desktop settings
  1. In the ChatGPT desktop app, open Settings, then MCP servers, then Add server.
  2. Name the server ApexGenius, choose Streamable HTTP, and paste the MCP address below.
  3. Save, select Restart, then Authenticate. Sign in to ApexGenius and authorize the intended connections and access.
  4. Start a new Codex task and ask one read-only question. Check the returned result and its matching successful read in Activity.
https://server.autom8.pro/mcp
OpenAI desktop MCP settings (opens in a new tab)
Manual setup for developers

Codex CLI is optional. Run these commands, complete browser authorization, then start a new session. Do not paste bearer tokens or static authorization headers.

Register the remote MCP server

codex mcp add apexgenius --url https://server.autom8.pro/mcp

Authorize in your browser

codex mcp login apexgenius

Inspect registered servers

codex mcp list

The desktop app, CLI, and IDE extension share MCP configuration on the same host. The IDE extension does not install plugins. ChatGPT web does not read local Codex configuration.

3. Verify one safe read

Show the spaces, folders and lists in my connected ClickUp workspace. Do not create or change anything.

Show the spaces, folders and lists in my connected ClickUp workspace. Do not create or change anything.

Compare the returned account and resource with ClickUp. Check the connection status separately from the result of the first read.

Full guide: the ClickUp setup guide.

What it looks like in Codex

Illustration of a task, not a recorded customer result. Your answers come from the account and dates you choose.

How the route works
Codex
CodexApexGenius MCP route
Show the spaces, folders and lists in my ClickUp workspace. Do not change anything.
ApexGenius
Working with ApexGenius1 tool search · 1 read
RequestMap the workspace
Account scopeAuthorized connections checked
apex_search_toolsClickUp workspace · Find ClickUp readsComplete
apex_call_read_toolGet Workspace Hierarchy · Read the workspace hierarchyComplete
Codex

Illustrative example: the workspace has three spaces, Product, Marketing and Operations. Product holds a Sprint folder with Backlog and Sprint 12 lists. Nothing was changed.

Read-only route
Codex

What to ask Codex about ClickUp

  • Map the workspace

    Show the spaces, folders and lists in my ClickUp workspace. Do not change anything.

    Runs Get Workspace Hierarchy (read).

  • Find a task

    Find the task about the login bug and show its status, assignee and due date.

    Runs Search Workspace (read), then Get Task (read).

  • Summarize a thread

    Summarize the comments on this task and list the action items.

    Runs Get Task Comments (read), then Get Threaded Replies (read).

These 3 questions use 5 of ClickUp’s 48 operations. The full list is below.

  • List the open tasks in the Sprint list with their assignees and due dates. (read)
  • Create a task in the list I name, assign it to me, and set the due date for Friday. (write)

What Codex can do in ClickUp

48 operations: 20 read, 28 write. Read looks things up and changes nothing. Writes change ClickUp and run only when you turn them on.

Search

3 read
  • Search Workspaceread
  • Search tasks by task typeread
  • Search tasks by tagread

Tasks

1 read · 6 write
  • Get Taskread
  • Create Taskwrite
  • Update Taskwrite
  • Set Custom Fieldswrite
  • Create Bulk Taskswrite
  • Update Bulk Taskswrite
  • Delete taskwrite

Comments and files

2 read · 2 write
  • Get Task Commentsread
  • Get Threaded Repliesread
  • Create Task Commentwrite
  • Attach File to Taskwrite

Tags, links and moves

8 write
  • Add Tag to Taskwrite
  • Remove Tag from Taskwrite
  • Add task linkwrite
  • Remove task linkwrite
  • Add dependencywrite
  • Remove dependencywrite
  • Move task to a new Listwrite
  • Add task to another Listwrite

Spaces, folders and lists

3 read · 5 write
  • Get Workspace Hierarchyread
  • Get Listread
  • Get Folderread
  • Create Listwrite
  • Create List in Folderwrite
  • Update Listwrite
  • Create Folderwrite
  • Update Folderwrite

Time tracking and status

5 read · 3 write
  • Get Task Time Entriesread
  • Get time entries for multiple tasksread
  • Get Current Time Entryread
  • Get Time in Status for a taskread
  • Get Time in Status for tasks in a Listread
  • Start Time Trackingwrite
  • Stop Time Trackingwrite
  • Add Time Entrywrite

Members

3 read
  • Get Workspace Membersread
  • Find Member by Nameread
  • Resolve Assigneesread

Chat

1 read · 1 write
  • Get Chat Channelsread
  • Send Chat Messagewrite

Docs

2 read · 3 write
  • List Document Pagesread
  • Get Document Pagesread
  • Create Documentwrite
  • Create Document Pagewrite
  • Update Document Pagewrite

You choose the access. When you approve Codex, pick Full access, Read only, or Custom.

ClickUp sets the boundary. The connection reaches what the signed-in ClickUp user can reach in the authorized workspace.

Reads use a route that checks ClickUp's own read-only label before every call.

Writes run immediately. Blocked hides a tool from agents.

ClickUp limits MCP calls by plan: without the Everything AI add-on, 50 calls per 24 hours on Free Forever and 300 on Unlimited and above. ClickUp's MCP server is in public beta.

Disconnecting stops future gateway access. It does not undo a task change, comment, chat message or deletion that already ran.

Start free

Questions about connecting Codex to ClickUp

Updated November 12, 2026.

How do I connect Codex to ClickUp?

Connect Codex to ClickUp through ApexGenius in three steps. Sign in to ApexGenius and connect ClickUp by signing in to ClickUp in the browser. In the ChatGPT desktop app, open Plugins and connect an ApexGenius plugin, or open Settings, then MCP servers, then Add server, and add the ApexGenius MCP address as a Streamable HTTP server. Then open a task in Codex and ask a question about your ClickUp. Start with a read, so nothing changes.

How do I check that Codex can use ClickUp?

In the Codex composer, type /mcp to view the connected servers. ApexGenius should be listed. If it asks for sign-in, open Settings, then MCP servers, and select Authenticate. Start a new task, then ask: “Show the spaces, folders and lists in my connected ClickUp workspace. Do not create or change anything.”

Is there a ClickUp MCP server for Codex?

Yes. ApexGenius is an MCP server that Codex connects to once. It carries your ClickUp connection and 48 ClickUp operations, so Codex does not need a separate ClickUp integration or plugin. You set it up one time and add each agent the same way.

What can Codex do in ClickUp once it is connected?

Codex can run 48 ClickUp operations through ApexGenius: 20 reads that search the workspace and read tasks, comments, docs, members, Chat channels and time entries, and 28 writes that create and update tasks, comments, lists, folders, docs and time entries, send Chat messages and delete a task.

Can Codex read my whole ClickUp workspace?

Only what the signed-in ClickUp user can reach in the authorized workspace. ClickUp sets that boundary, and no API key is pasted into ApexGenius. ClickUp also limits MCP calls per day by plan, so check your plan before a big job.

Can Codex change my ClickUp?

Not until you allow writes. Reads go through a route that checks ClickUp’s read-only label. With writes on, they run right away, and comments and Chat messages notify people when posted. Deleting a task is marked destructive. Turn any tool off to block calls.

Can I use the same ClickUp connection with Claude, ChatGPT, Grok Bot or Muse?

Yes. One ClickUp connection in ApexGenius works with every compatible agent you add, including Claude, ChatGPT, Grok Bot or Muse. Each agent gets its own access choice and its own short setup. The ClickUp skill loads in all of them, so it travels with the connection.

Connect ClickUp to Codex today

Start free

1,000 free credits. No card required. Disconnect any time.