Skip to main content

Codex

Codex supports MCP servers in the CLI and in the IDE extension. Both clients share the same MCP configuration.

Option 1 Configure with the CLI​

Add the server

codex mcp add postmypost --url https://mcp.postmypost.io/v1

Verify it is configured

codex mcp list

The codex mcp add and codex mcp list commands are the standard way to manage MCP servers in Codex.

Option 2 Configure with config.toml​

Codex stores MCP configuration in ~/.codex/config.toml. You can also scope it per project using .codex/config.toml in trusted projects.

Add an HTTP MCP server

[mcp_servers.postmypost]
url = "https://mcp.postmypost.io/v1"
bearer_token_env_var = "POSTMYPOST_TOKEN"

For streamable HTTP servers, Codex supports bearer token auth using bearer_token_env_var.

Export the token in your shell

export POSTMYPOST_TOKEN="YOUR_API_TOKEN"

After this, restart Codex and run codex mcp list to confirm the server is enabled.