Skip to main content

Codex

OpenAI Codex is OpenAI's agentic coding CLI. MCP servers are registered via codex mcp add or directly in ~/.codex/config.toml. Codex supports OAuth — running codex mcp login starts the browser flow against our auth server.

Setup​

1. Register the server​

In your terminal:

codex mcp add inboxmcp --url https://mcp.inboxmcp.io/mcp

Or directly in ~/.codex/config.toml:

[mcp_servers.inboxmcp]
url = "https://mcp.inboxmcp.io/mcp"

2. OAuth login​

codex mcp login inboxmcp

The browser opens, you sign in to inboxmcp and confirm access. Codex stores the token safely and refreshes it automatically.

Config options​

If Codex needs a fixed OAuth callback port (some firewalls / setups):

[mcp_servers.inboxmcp]
url = "https://mcp.inboxmcp.io/mcp"
mcp_oauth_callback_port = 8765

Status & revoke​

codex mcp list             # show all servers
codex mcp remove inboxmcp  # remove the entry