Codex Control Plane MCP Server

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

Local serverstdioPython

What is the Codex Control Plane MCP Server?

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.

Recorded tools

  • 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
  • codex_interrupt_turn — codex_archive_thread
  • codex_unarchive_thread — codex_start_thread_compaction

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
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
codex_get_thread_compaction_statuscodex_get_runtime_capabilities
codex_health_summarycodex_collect_diagnostics
codex_start_chatcodex_send_message
codex_execute_plancodex_list_projects
codex_list_project_chatscodex_list_active_chats
codex_search_chatscodex_get_chat_status
codex_get_chatcodex_get_turn_status
codex_restart_app_servercodex_get_app_server_status
codex_get_diagnostic_logscodex_analyze_issue

How to install the Codex Control Plane MCP Server

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

From the project documentation. Replace placeholders and example paths before connecting.

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

Durable MCP control plane for long-running Codex Desktop tasks. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.