Some screenshots show mcp-s.com, which some existing organizations still use. New organizations use withwillow.ai. Copy the URLs shown in your own organization.
Connect Codex to Willow
Use OpenAI Codex with your organization's Willow tools. The Codex CLI, Codex in the ChatGPT desktop app, and the Codex IDE extension share one MCP config (~/.codex/config.toml), so you only set Willow up once.
ChatGPT web (chatgpt.com) connects through Plugins — see Connect ChatGPT. Codex inside the ChatGPT desktop app uses these Codex instructions, not the ChatGPT Plugins flow.
Prerequisites
- Codex CLI (
codex --version), the ChatGPT desktop app with Codex, or the Codex IDE extension - Your organization's Willow URL (from the Connect MCP modal)
Step 1: Get Your Connection URL
In Willow, click Connect MCP at the bottom of the left sidebar.
Select Codex (or any tool) and copy the Server URL. The gateway URL is the same for every tool.
Step 2a: ChatGPT desktop (Codex)
- Open the ChatGPT desktop app and switch to Codex
- Open Plugins → MCPs, then select Add → Add MCP server
- Enter a name (e.g.
willow), choose Streamable HTTP, and paste the Server URL - Save, then Restart
- If prompted, click Authenticate and complete the Willow sign-in
- In a Codex chat, type
/mcpto confirm Willow is listed
Step 2b: Codex CLI
Run this command, replacing the URL with the one you copied:
codex mcp add willow --url "https://yourorg.withwillow.ai/mcp"
willow is the name you're giving this connection. You can use any name.
Codex adds the server, detects OAuth support, and starts the auth flow immediately. No separate login step needed.

Open the URL in your browser. Log in to your Willow account if prompted, then complete the authorization.

The browser confirms authentication is complete.

Back in the terminal, Codex confirms with Successfully logged in.

Codex stores the credentials and uses them automatically on future connections.
This writes the server to ~/.codex/config.toml (global). To scope it to a project instead, add it to .codex/config.toml in your project root:
[mcp_servers.willow]
url = "https://yourorg.withwillow.ai/mcp"
Step 3: Verify the Server is Connected
In a Codex TUI session, run:
/mcp
You should see willow listed with its Auth method, URL, and available tools.

Step 4: Verify It Works
Ask Codex:
"List what tools you have access to in Willow MCP"
Codex will inspect the available tool metadata and list them under the mcp__willow__ namespace.
The tools you see will depend on which MCP servers your organization admin has installed, which tools on those servers they have enabled, and what tools each MCP server exposes. Your list may look different from the one shown here.

Troubleshooting
Server not listed after /mcp
- Check that
~/.codex/config.tomlhas the correct[mcp_servers.willow]entry withurl - Confirm the URL matches what the Connect MCP modal shows
OAuth login fails
- Ensure you have accepted the invite from your admin
- Re-run
codex mcp login willowto redo the auth flow
Tools not available after authenticating
- Run
/mcpto confirm the server initialized correctly - See General Troubleshooting
willow CLI fails with network/connection errors inside Codex
- Codex's default
workspace-writesandbox blocks outbound network, so the CLI can't reach the gateway. Enable network access — see Running inside OpenAI Codex.
Related
- All AI Clients: Setup for other clients
- Connection Methods: Choosing what a connection gives your AI