Skip to main content

Add Onyx

Sign in and select Allow access. In Codex, enter /mcp to check that Onyx is connected, then send the test prompt. The Codex CLI, desktop app, and IDE extension share this configuration.

Configure with TOML

Instead of codex mcp add, add this to ~/.codex/config.toml, then run codex mcp login onyx:
Keep only one [mcp_servers.onyx] table in the file.

Personal access token

To use a token instead of OAuth, export a personal access token as ONYX_TOKEN and use this table:
Start codex from the shell that exports ONYX_TOKEN. A desktop app started separately may not see it.

Disconnect

This does not revoke access. Revoke it in Onyx under Connected apps.