MCP
OpenAI Codex
Wire Breeth into the Codex CLI as a remote MCP server.
The Codex CLI reads MCP servers from ~/.codex/config.toml. Add the Breeth block, restart Codex, and add_episode / search / get_entity_view show up as native tools.
Config
Replace YOUR_API_KEY with a key from breeth.com/app/api-keys:
[mcp_servers.breeth]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.thebreeth.com/mcp", "--header", "Authorization: Bearer YOUR_API_KEY"]Verify
Start Codex, open a chat, ask "list your MCP tools." Breeth's tool surface should appear.
Where files live
| OS | Path |
|---|---|
| macOS | ~/.codex/config.toml |
| Linux | ~/.codex/config.toml |
| Windows | %USERPROFILE%\.codex\config.toml |
Rotation
To swap the key, edit the same TOML file and restart Codex. There's no cached state — the new key is picked up on the next session.