Connect Codex

Add PMM Sherpa to OpenAI Codex CLI and IDE extension.

Codex (OpenAI's CLI and IDE extension) is a first-class MCP client. CLI and IDE share the same config.

One-line install#

codex mcp add pmm-sherpa --url https://pmmsherpa.com/api/mcp

Edit ~/.codex/config.toml and add:

[mcp_servers.pmm-sherpa]
url = "https://pmmsherpa.com/api/mcp"

Restart Codex. The four tools appear automatically.

The first tool call opens a browser for OAuth. If you prefer a static token (CI, restricted environments), set:

[mcp_servers.pmm-sherpa]
url = "https://pmmsherpa.com/api/mcp"
bearer_token_env_var = "PMM_SHERPA_TOKEN"

Then export PMM_SHERPA_TOKEN in your shell.

Tools not listed after restart: check TOML syntax ([mcp_servers.pmm-sherpa], not nested). Run Codex with verbose logging if needed.
OAuth never completes: allow pop-ups, then re-run any tool call.
CI / headless: switch to the bearer_token_env_var flow above.
Want staging: replace the URL with https://staging.pmmsherpa.com/api/mcp.