# Codex Control Plane MCP

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 124
- Author: aresyn
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/aresyn/codex-control-plane-mcp
- Updated: 2026-09-09
- HTML: https://affpapa.org/en/nevibecode/mcp/codex-control-plane-mcp

## What it 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`.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add codex-control-plane-mcp -- uvx 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>

### Codex

**Platform CLI**
```bash
codex mcp add codex-control-plane-mcp -- uvx 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>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "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>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "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>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add codex-control-plane-mcp uvx 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>

## When to use it
- 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
- 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/start` and retrieve the final diagnostic report.

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md