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 linearAuthorize 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
- 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