# Connect Codex with one command

One command from the app adds featureloom to Codex. From then on, your agent takes plans from your board.

- **5 minutes** (reading time)
- **Before you start**: a featureloom account, a project on your board, Codex installed

Download the recording: [Connect Codex with one command (MP4)](https://featureloom.com/_astro/film-en.DT6uHwyq.mp4). These four steps in one recording, with a narrator.

## 1. Open Integrations and choose your console

In the menu on the left, open Integrations. On the Your consoles card, press Connect console. The app asks which console you work from: choose Codex.

![The Connect console window with three consoles to choose from: Claude Code, Codex and Cursor](https://featureloom.com/_astro/step-1-en.D2531eFg_Zt48XY.webp)

Connect console: choosing the console

## 2. Copy the connect command

> If the window first shows Confirm it’s you, confirm the way you sign in. After your password or a passkey, the window shows the connect command right away. After Google, press Back, then Connect console and Codex again. featureloom asks once an hour.

The app shows the connect command, ready for your terminal, with a secret that works like the console’s password. You see it only now, so press Copy right away.

![The Connect Codex window with the connect command and the Copy button](https://featureloom.com/_astro/step-2-en.B158qhhO_2mpPJB.webp)

Connect Codex: the connect command to copy

> The connect command holds your secret. Don’t paste it into a chat or a repository.

## 3. Paste it in a system terminal

Paste the connect command in an ordinary system terminal, under the same system account that runs Codex, not inside the Codex window. It adds featureloom to Codex’s configuration file as an MCP server:

```sh
codex mcp remove featureloom; (d="${CODEX_HOME:-$HOME/.codex}"; mkdir -p "$d" && cd "$d" && touch config.toml && chmod 600 config.toml && printf '\n[mcp_servers.%s]\nurl = "%s"\nhttp_headers = { Authorization = "Bearer %s" }\n' featureloom 'https://mcp.featureloom.com/mcp' 'flc_…' >> config.toml)
```

On a first connection the terminal says there is no featureloom server yet: `No MCP server named 'featureloom' found.` That is fine.

## 4. Check the connection

Start Codex in the same terminal and type `/mcp` in it. featureloom shows connected:

```sh
/mcp
```

Expected output:

```text
• featureloom: connected
```

If Codex is already running, restart it.

In the app you will see that Codex is connected. Right after that, the app suggests the next step: give this console a plan. Open a plan with a prompt, copy the command under its contents and paste it in the console. The console reads the plan, realizes it and reports that on the board. The Open the board button takes you there.

![The Connect Codex window saying Connected: Codex, with the Open the board button](https://featureloom.com/_astro/step-4-en.CSUPD4Sd_Z2wb4An.webp)

Connected: Codex

## Good to know

- What the connect command does: codex mcp remove first removes an earlier featureloom server, if there is one. Then the command adds featureloom to Codex as a remote MCP server: it appends an [mcp_servers.featureloom] block with the address and your secret to Codex’s configuration file, ~/.codex/config.toml, which only your system account can read. In a terminal, codex mcp list shows the server too.
- On a computer with a browser you connect Codex with no secret: in the Connect Codex window open “Another way: sign in through the browser”, press Show the connect command and paste the Sign-in connect command instead of the one above. It adds the server with codex mcp add featureloom --url https://mcp.featureloom.com/mcp, and Codex opens the sign-in in your browser.
- This way works only with a browser on the same computer that runs Codex. In a terminal over SSH, use the connect command with the secret.
- The connect command with the secret stops working after 90 days, or after 14 days without use. A lost or inactive one is replaced with a new one: Reconnect.
- You can have up to 10 consoles at once. You disconnect them in Your consoles.
- The [Codex integration](https://featureloom.com/en/integrations/codex/) page shows how Codex works with your board and what it may do there.

Updated: November 8, 2026

## Next: Your agent writes a plan from a console conversation

Your console is connected: tell your agent what you need, and it creates the plan on your board.

[See the tutorial](https://featureloom.com/en/tutorials/your-agent-writes-a-plan-from-a-console-conversation/)