Skip to content

Connect Codex to Linear

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

Connect LinearSee the setup

7 days free · No card required

How to connect Linear to Codex

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

FirstConnect Linear to ApexGenius

ThenConnect ApexGenius to Codex

Linearmcp.linear.app/authorize1 of 3

Connect Linear. Linear opens its own sign-in. Sign in and allow ApexGenius.

Then ask Codex:

List my five most recently updated Linear issues. Read only; do not change anything.

Written setup, step by stepShow

Before you start

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

1. Connect Linear to ApexGenius

  1. Open Linear 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 Linear in the browser, choose the workspace, and approve read and write access. Linear uses browser authorization; no API key is pasted into ApexGenius. Each workspace needs its own connection.
    The full Linear consent page, ApexGenius is requesting access, with red boxes around the details table and the Approve button.
    Linear names ApexGenius, its callback address and Read, Write access. Approve connects your workspace. Cancel stops without connecting.Open full-size image (opens in a new tab)
  3. Review the connected account and resources. Confirm the connected Linear workspace. Open Tools to review the issue, project, cycle and comment actions. Writes run right away, and Linear notifies subscribers.
  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 Linear →

2. Connect ApexGenius to Codex

  1. In the desktop app, open Settings, then MCP servers and Add server.
  2. Name the server ApexGenius, choose Streamable HTTP, and paste the MCP address above.
  3. Save, then select Restart. Choose Authenticate for ApexGenius and complete the browser sign-in.
  4. When ApexGenius asks what this AI client may use, choose Read only for the first test, or Custom to limit it to the tools you need.
  5. Start a new conversation and select ApexGenius from the available tools before asking for live data.
Official Codex setup instructions ↗

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)

Step 1 of 4Open Plugins

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.

OpenAI Plugins guide (opens in a new tab)Full Codex setup guide
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

List my five most recently updated Linear issues. Read only; do not change anything.

List my five most recently updated Linear issues. Read only; do not change anything.

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

What Codex can do in Linear

11 operations. Read looks things up and changes nothing. Write changes Linear and runs only when that tool is enabled.

Read9 operations

Looks things up. Changes nothing.

Issues

  • list_issuesFind issues by team, assignee, project, label, status, priority or cycle.
  • get_issueRead one issue with its details.

Projects

  • list_projectsBrowse projects in the workspace.
  • get_projectRead one project, including milestones and members.
  • get_status_updatesRead the latest status updates on a project or initiative.

Cycles

  • list_cyclesList a team’s cycles.

Comments

  • list_commentsRead the comments on an issue.

Teams and people

  • list_teamsList the teams in the workspace.
  • list_usersLook up people to find an assignee, lead or owner.

Write2 operations

Changes Linear. Runs only when enabled.

Issues

  • save_issueCreate an issue or update one: title, team, assignee, project, labels, priority, status.

Comments

  • save_commentPost a comment or edit one.

You choose what Codex can use

When you approve Codex, pick Full access, Read only, or Custom. Read only allows the Read operations and nothing else. Custom picks apps and tools one by one.

Limits in Linear

  • · One connection covers one Linear workspace. Connect again for another workspace.
  • · Your Linear permissions set what the connection can reach. ApexGenius tool controls do not add Linear permissions.
  • · The read route checks Linear’s live read-only label and rejects writes.
  • · Enabled writes run immediately. Turn a tool off to block calls.
  • · ApexGenius cannot undo a Linear change. Disconnecting stops future gateway access; it does not reverse an issue, update or comment that already ran.

What it looks like in Codex

An illustrative read-only request and response. Your results come from the account and dates you choose.

How the route works
Codex
CodexApexGenius MCP route
List my five most recently updated Linear issues. Read only; do not change anything.
ApexGenius
Working with ApexGenius1 tool search · 1 read
RequestRecent issues
Account scopeAuthorized connections checked
apex_search_toolsLinear issues · Find the Linear read routeComplete
apex_call_read_toollist_issues · List recently updated issuesComplete
Codex

Illustrative example: five issues changed in the last two days, each with its team, status and assignee. Compare the workspace with the one you connected. Nothing was changed.

Read-only route
Codex

Try asking

“List my five most recently updated Linear issues. Read only; do not change anything.”

“Summarize what my team finished in the last completed cycle.”

“Read the latest status updates on the project I name and list the open risks.”

“Create an issue in the team I name with this title and description. Show me the draft first.”

More connections like this one

One ApexGenius account covers every pair below. Connect an app once and each agent you allow can use it.

Questions people ask first

How do I connect Linear?

Open Linear in ApexGenius Connections, choose Connect, sign in to Linear in the browser and pick the workspace. No Linear API key is pasted into ApexGenius.

Which Linear tools can my AI use?

The ones Linear publishes on its hosted MCP. ApexGenius reads Linear’s live list on every search, so the list on this page is what Linear documents today, and Linear may add tools.

Can my AI create or change issues?

Yes, when your Linear permissions allow it. Enabled writes run immediately. Turn a tool off to block calls.

Can ApexGenius undo a change?

No. To reverse an edit, save the old value back. Linear notifies subscribers of new issues and comments, and a sent notification cannot be recalled.

Can I start with read-only access?

Yes. Choose Read only when you add your AI agent. Reads go through the read route, which checks Linear’s live read-only label before each call.

Can I connect more than one workspace?

Yes. Each Linear workspace needs its own connection and its own sign-in.

Connect Linear to Codex today

Start free

7 days free. No card required. Disconnect any time.