← All connection guides

How to connect Codex to Linear

Connect Codex to Linear, authorize access, and verify the connection using the official setup.

Free guide · Updated

Based on official documentation · Checked

Ask your agent

Copy the prompt and paste it into your assistant.

Quick answer

Connect Codex to Linear using the official Linear setup described below, authorize the account, then check access with a read-only request.

Before you start

Install Codex and sign in to an account with access to the intended Linear workspace or projects. Review the permissions requested during authorization; connecting a tool can expose account data or allow changes depending on the integration.

Add the connection

Register Linear’s read-only MCP endpoint in Codex from a terminal.

codex mcp add linear --url https://mcp.linear.app/mcp/readonly
codex mcp login linear

Authorize the account

Complete the browser authorization for your Linear workspace. Codex CLI and the IDE extension use the same MCP configuration. The read-only endpoint does not expose write tools.

Practice

Check the connection

  1. Ask Codex to list a few issues in a named Linear project and compare the results with Linear.

Output: The result matches data visible in your Linear account.

Troubleshooting and disconnecting

If tools are missing, check the server or plugin status in Codex, restart the session if necessary and confirm you authorized the correct Linear account. If access is denied, check your workspace membership and permissions. To disconnect, remove or disable the server or plugin in the client and revoke its authorization in Linear when appropriate. Avoid pasting access tokens into public files.

Sources

Read the primary material