Connect Codex to Omnido (MCP)

In a Codex session in the terminal, work turns up that has to wait. Omnido is an MCP server. With one command you add Omnido to Codex, and Codex adds that work as a task while you keep working.

You need an Omnido account for this. Sign in to Omnido (opens in a new tab) ; a new account is created along the way with the login code sent by email; registration is open.

1. Create the access key in Omnido

Open Settings → “Omnido in other apps” and choose “Other AI program”. Enter a name such as “Codex · Laptop”. Under “What may it do?” leave “Read and change” selected; only with it can Codex create tasks. Then choose “Create key”.

Omnido shows the “Address” https://omnido.saschahenning.de/mcp and the header “Authorization” with Bearer omn_…. Codex needs only the part after Bearer , the key that starts with omn_. Omnido shows it only this once.

2. Store the key in an environment variable

Codex reads the key from an environment variable, so it does not sit in the config file. Add this line to your ~/.zshrc (~/.bashrc for Bash) and open a new terminal:

export OMNIDO_KEY="omn_YOUR_ACCESS_KEY"

3. Add Omnido to Codex

codex mcp add omnido --url https://omnido.saschahenning.de/mcp --bearer-token-env-var OMNIDO_KEY

The command writes this section to ~/.codex/config.toml. You can also add it there yourself:

[mcp_servers.omnido]
url = "https://omnido.saschahenning.de/mcp"
bearer_token_env_var = "OMNIDO_KEY"

4. Check the connection

codex mcp list shows omnido with its address. In a running Codex session, /mcp lists the active servers and their tools. If omnido is missing there, OMNIDO_KEY was not set when Codex started. So start Codex from a terminal that already has the line from step 2.

5. Ask Codex for a task

Tell Codex, for example: “Create a task in Omnido: check the migration for the invoice table, by Monday.” Codex calls create_task, and the task is in your list at once. With add_capture the text goes to the inbox instead, where you check it.

Codex gets the same tools as Claude Code; the list per access right is in the Claude Code guide . No tool deletes a task.

Remove access

Under Settings → “Omnido in other apps” → “Has access to Omnido”, choose “Remove” next to the key. It stops working at once. On your computer, codex mcp remove omnido deletes the entry; take the OMNIDO_KEY line out of your shell file.

Before you start

The privacy policy explains what Omnido logs when an AI program writes. If the “Other AI program” option shows “Needs a subscription” in your account, the Pricing page explains the subscription. We wrote the commands from OpenAI’s MCP guide for Codex (opens in a new tab) , as of 12 November 2026.