Codex Control Plane MCP Server

Durable MCP control plane for long-running Codex Desktop tasks.

Local serverstdioPython

What is the Codex Control Plane MCP MCP server?

If you already use Codex Control Plane MCP, the codex control plane mcp mcp server is the piece that lets your assistant work with it directly. Durable MCP control plane for long-running Codex Desktop tasks.

What the server does

codex-control-plane-mcp turns Codex Desktop and codex-app-server into a durable worker that an MCP client can drive safely. Send a task, get an operationId or workflowId right away, poll until the work finishes, approve Plan Mode when needed, then read the final report.

Installation

The server ships on PyPI as codex-control-plane-mcp, so your MCP client can launch it on demand — there is no separate build step. Add the server block to your client's configuration, restart it, and the tools register themselves.

Available tools

The toolset is worth reading before you wire it up, because it tells you what the integration is really for:

  • Local-first — not intended to be exposed as a public network service
  • Retry — safe client_request_id handling
  • MCP — owned hook history in SQLite for search, summaries, and fallback reads
  • codex_get_worker_status — codex_get_queue_status
  • codex_get_concurrency_status — codex_get_worker_command_status
  • operationRowAgeSeconds — age of the durable operation row;
  • turnFreshness.lastProgressAgeSeconds — age of the last turn progress event;
  • workerFreshness.heartbeatAgeSeconds — age of the worker heartbeat;
  • codex_submit_task — codex_get_operation_status
  • codex_start_plan_workflow — codex_start_review_workflow
  • codex_get_workflow_status — codex_approve_plan
  • codex_list_pending_interactions — codex_answer_pending_interaction

Worth knowing first

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Codex Control Plane MCP.
  • Keep per-call confirmation enabled while you learn its behaviour; it is the cheapest safeguard you have.

Where it fits

This sits in the database access group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Codex Control Plane MCP's toolset — Local-first, Retry, MCP and 11 more — is a fair guide to whether it matches your workflow. It is maintained by aresyn; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Codex Control Plane MCP's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
Local-firstnot intended to be exposed as a public network service.
Retrysafe client_request_id handling.
MCPowned hook history in SQLite for search, summaries, and fallback reads.
codex_get_worker_statuscodex_get_queue_status
codex_get_concurrency_statuscodex_get_worker_command_status
operationRowAgeSecondsage of the durable operation row;
turnFreshness.lastProgressAgeSecondsage of the last turn progress event;
workerFreshness.heartbeatAgeSecondsage of the worker heartbeat;
codex_submit_taskcodex_get_operation_status
codex_start_plan_workflowcodex_start_review_workflow
codex_get_workflow_statuscodex_approve_plan
codex_list_pending_interactionscodex_answer_pending_interaction
codex_interrupt_turncodex_archive_thread
codex_unarchive_threadcodex_start_thread_compaction

How to install the Codex Control Plane MCP MCP server

Minimal stdio entry:

```json
{
  "mcpServers": {
    "codex-control-plane": {
      "command": "codex-control-plane-mcp",
      "args": []
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Example prompts to try

  • Use Codex Control Plane MCP to Local-first.
  • Use Codex Control Plane MCP to Retry.
  • Use Codex Control Plane MCP to MCP.

Frequently asked questions

It connects Codex Control Plane MCP to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (Local-first, Retry, MCP, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Codex Control Plane MCP directly.