Connect OpenAI Codex CLI
OpenAI's terminal agent. Configured in TOML rather than JSON.
~/.codex/config.toml, or .codex/config.toml in a trusted project
Before you start
Create an API key in the app under Settings, then API Keys. Grant only the permissions this agent needs. The key is shown once. Replace pk_live_xxx in the snippets below with it.
Hosted endpoint
Recommended. Nothing to install, and it stays current without you upgrading anything.
[mcp_servers.planpost]
url = "https://mcp.planpo.st/mcp"
bearer_token_env_var = "PLANPOST_API_KEY"Local install
Runs the MCP server on your own machine through npx, so your key never leaves it. Needs Node 18 or newer.
[mcp_servers.planpost]
command = "npx"
args = ["-y", "planpost-mcp"]
[mcp_servers.planpost.env]
PLANPOST_API_KEY = "pk_live_xxx"Things that catch people out
- The hosted form reads the token from an environment variable rather than the file, so export PLANPOST_API_KEY in your shell.
- `codex mcp add` does the same thing interactively if you would rather not edit TOML.
Check it works
Ask the agent to list your connected accounts. If it comes back with them, all 47 tools are available.
Which social accounts do I have connected on planpo.st?