Codex

Connect the Catio MCP to Codex

1. Add the server

Add to ~/.codex/config.toml (or .codex/config.toml in a trusted project):

[mcp_servers.catio]
url = "https://mcp.catio.tech/mcp"

Or use the CLI:

codex mcp add catio --url https://mcp.catio.tech/mcp

You do not need a client ID or callback URL.

In the Codex desktop app, open Settings → MCP servers → Add server, choose Streamable HTTP, enter the URL, save, and restart.

2. Authenticate

codex mcp login catio

Follow the browser flow to select your org and workspace. On a machine without a browser, add --no-browser, open the printed URL elsewhere, and paste the full redirect URL back into the terminal. In the desktop app, select Authenticate on the server.

3. Verify

codex mcp list

Or use /mcp in the TUI. Then ask:

Tell me about my Catio session

Sign in again

Run codex mcp login catio again. Run codex mcp --help to see the other commands in your version.


Did this page help you?