Skip to content →

Connect Codex to the Linear MCP server

Overview

Codex is a coding agent that works everywhere you do. Connecting Linear’s MCP server to the Codex CLI or Codex IDE Extension gives Codex access to gain context from your existing issues or create new issues without the need to copy & paste.

You can only use the MCP server for local Codex tasks using the CLI or IDE Extension.

Setup instructions

The setup steps for the MCP server are the same regardless of whether you use the IDE Extension or the CLI since the configuration is shared.

Preferred: using the CLI

If you have the CLI installed you can run the following command:

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

This will automatically prompt you to log in with your Linear account and connect it to your Codex.

Note: If this is the first time you are using an MCP in Codex you will need to enable the rmcp feature for this to work. Add the following into your ~/.codex/config.toml:

[features]
rmcp_client = true

Manual set up

  1. Open the ~/.codex/config.toml file in your preferred editor
  2. Add the following:
[features]
rmcp_client = true
 
[mcp_servers.linear]
url = "https://mcp.linear.app/mcp"

Then Run codex mcp login linear to log in.

Start building

Build your own integration

Create your own integration with Linear’s API and submit it to the directory.