Codex Control Plane MCP — Claude Code MCP server: setup guide
Runs long tasks in Codex Desktop via an asynchronous polling queue backed by SQLite. Ideal when jobs take hours and cannot block the MCP connection.
claude mcp add codex-control-plane-mcp -- uvx codex-control-plane-mcpWhat Codex Control Plane MCP does
This server bridges client tools with codex-app-server without hanging active connections. Whenever you submit a job, the runner issues an immediate operationId or workflowId. You can inspect progress on demand and approve pending questions before retrieving final reports. Client retries stay safe against duplicate generation turns thanks to unique request tracking.
All operations and workflow logs live inside a local SQLite database. The tooling supports forking threads, steering context into active turns, running code reviews, and returning structured output schemas. It drives actions strictly through codex-app-server, avoiding modifications to internal Codex databases or transcript files.
Live execution requires Windows alongside Codex Desktop, while macOS and Linux only support protocol verifications. Plan Mode rejects read-only sandboxes and elevates the execution profile to workspace-write.
What it helps with
- Queue multi-hour Codex tasks without hitting MCP connection timeouts
- Prevent duplicate generation turns on network retries using request IDs
- Manage approvals and execution steps for Plan Mode workflows
- Inspect health diagnostics and persist operation history in local SQLite
Example prompts for the agent
- Submit this migration job to Codex Control Plane and give me the
operationId. - Poll the status of the current Codex workflow and check for pending questions.
- Trigger a code review run via
review/startand retrieve the final diagnostic report.
How to install Codex Control Plane MCP
Platform CLI
claude mcp add codex-control-plane-mcp -- uvx codex-control-plane-mcpuvx runs the command named after the package; if the README names another one, use uvx --from codex-control-plane-mcp <command>
Platform CLI
codex mcp add codex-control-plane-mcp -- uvx codex-control-plane-mcpuvx runs the command named after the package; if the README names another one, use uvx --from codex-control-plane-mcp <command>
Config file
{
"mcpServers": {
"codex-control-plane-mcp": {
"command": "uvx",
"args": [
"codex-control-plane-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from codex-control-plane-mcp <command>
Config file
{
"servers": {
"codex-control-plane-mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"codex-control-plane-mcp"
]
}
}
}uvx runs the command named after the package; if the README names another one, use uvx --from codex-control-plane-mcp <command>
Platform CLI
gemini mcp add codex-control-plane-mcp uvx codex-control-plane-mcpuvx runs the command named after the package; if the README names another one, use uvx --from codex-control-plane-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about Codex Control Plane MCP
How to install Codex Control Plane MCP in Claude Code?
Run claude mcp add codex-control-plane-mcp -- uvx codex-control-plane-mcp in your terminal.
What does Codex Control Plane MCP do?
It converts codex-app-server interactions into durable asynchronous operations, providing status polling, approval flows, and local state persistence.
Which operating systems are supported?
Full live orchestration requires Windows with Codex Desktop, because Linux and macOS are limited to protocol checks.
