Skip to content
OpenPostDocs
OpenPostDocs

Connect Codex

Add OpenPost to Codex with remote MCP and browser sign-in.

Connect OpenPost once to review a schedule or prepare a draft from Codex. Codex CLI, its IDE extension, and the ChatGPT desktop app share the MCP configuration for the same host.

Add OpenPost

Open Settings → MCP servers → Add server in the desktop app, choose Streamable HTTP, enter https://app.openpo.st/mcp, and save. Or add this entry to ~/.codex/config.toml for Codex CLI:

[mcp_servers.openpost]
url = "https://app.openpo.st/mcp"

In the desktop app, restart and choose Authenticate beside OpenPost. From Codex CLI, run:

codex mcp login openpost

Complete OpenPost's browser sign-in. Choose mcp:read to inspect your workspace, or mcp:full to let Codex change publications. Start a new session after adding the server.

Check the connection

In Codex CLI, run codex mcp list; in the desktop app, check the MCP server list. Then ask Codex, "List my OpenPost workspaces." Name one and ask for its schedule without making changes.

If it does not connect

Authenticate again if the login expired. Check that the configured URL ends in /mcp. For a private self-hosted server, use the local bridge with command = "openpost-mcp" and args = ["--profile", "local"] in the configuration. That bridge runs on the same machine as Codex.

See Codex MCP configuration for client settings.

On this page