Gadwal
Coming soon

Connect Codex

Works for the Codex CLI, the IDE extension and the Codex app. This is also how ChatGPT users connect.

Before you start

  1. Open Gadwal and choose Gadwal › Settings (⌘,), then the AI & MCP tab.
  2. Turn on MCP server. The Address line shows http://127.0.0.1:55183/mcp (you can change the port below it). The server only listens on this Mac.
  3. Check each connection's AI level in its connection settings: Off, Read-only, Ask before write or Full. Production connections start at Read-only. The AI only sees connections that aren't Off.

AI tools need an active trial or the lifetime unlock. On the free tier the server answers every tool call with a message saying so.

Add the server

  1. In Settings › AI & MCP › Connect AI, click Copy config.toml Block on the Codex row. You get:

    [mcp_servers.gadwal]
url = "http://127.0.0.1:55183/mcp"
http_headers = { "Authorization" = "Bearer <token>" }

  2. Open ~/.codex/config.toml in a text editor (create it if it doesn’t exist) and paste the block at the end.

  3. Restart Codex. Ask it to list your Gadwal connections.

The token is written in the header on purpose. Codex can also read a token from an environment variable, but the Codex app started from the Dock doesn’t see variables set in your shell profile.