Skip to main content
skill CX Codex

codex-control-plane-mcp — Claude Code skill: install, how it works

codex-control-plane-mcp is a Claude Code and Codex skill that turns Codex Desktop into a durable worker for long tasks via an MCP server.

no license 100 installs ★ 9 updated 2026-10-09

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add reason-machines/mcp-skills --skill codex-control-plane-mcp -a claude-code
Open on GitHub

What codex-control-plane-mcp does

Instead of blocking multi-hour calls, the skill provides an async model: submit a task, get an operationId, poll until done. The same client_request_id returns the existing operation rather than spawning a duplicate. For Plan Mode, it starts a plan, waits for approval, executes, and fetches the final report. Uses a SQLite database to persist operations, workflows, hooks, and diagnostics.

Requires Python (for pipx or uvx) and environment variables CODEX_MCP_STATE_DB and CODEX_PROJECTS_ROOT. After installing hooks with codex-control-plane-mcp-hooks install, restart Codex Desktop. MCP client config goes into a JSON block in claude_desktop_config.json or the equivalent for your platform.

Built for automation that must not break on retries or lose state: lengthy refactors, database migrations, batch file processing. Without SQLite and the CODEX_MCP_STATE_DB variable, the server will not start.

What it helps with

  • run a long Codex Desktop task without blocking
  • retry a Codex request without creating duplicate operations
  • manage Plan Mode: approve a plan and wait for execution
  • track operation or workflow status by ID
  • persist operation and hook history in SQLite

Example prompts for the agent

  • Set up the MCP server for long Codex Desktop tasks with a database at ./state/codex-mcp-state.sqlite3
  • Submit an auth module refactor via codex_submit_task and return the operationId
  • Start a Plan Mode workflow for MySQL to PostgreSQL migration and wait for approval

How to install codex-control-plane-mcp

1Skills CLI (Vercel)

npx skills add reason-machines/mcp-skills --skill codex-control-plane-mcp -a claude-code

2Manually: put the files in place

~/.claude/skills/codex-control-plane-mcp/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/codex-control-plane-mcp/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about codex-control-plane-mcp

How do I install codex-control-plane-mcp in Claude Code?

Run npx skills add reason-machines/mcp-skills --skill codex-control-plane-mcp -a claude-code, then open ~/.claude/skills/codex-control-plane-mcp/SKILL.md for MCP client setup instructions.

What does codex-control-plane-mcp do?

Turns Codex Desktop into a durable worker: submit a task asynchronously, get an ID, poll for status, retry without duplicates. Supports Plan Mode with approval and stores history in SQLite.

What does the skill need to run?

Python, pipx or uvx, environment variables CODEX_MCP_STATE_DB and CODEX_PROJECTS_ROOT. After installing hooks with codex-control-plane-mcp-hooks install, restart Codex Desktop.

Similar skills

All skills for Agent setup: memory, context, orchestration →

From the same set98

The whole set →
mcp-servers-essential-reference mcp-servers-essential-reference is a Claude Code skill with installation commands and security guidance for 50+ MCP servers across development, data, ops, and integrations. CX Codex +1 110installs multi-llm-mcp-server The multi-llm-mcp-server skill connects Claude Code with Codex CLI and multiple language models. Use it to compare parallel model responses or hand code analysis to Codex. CX Codex +1 107installs excel-mcp-automation excel-mcp-automation is a Claude Code skill for working with Excel ranges, PivotTables, Power Query, DAX, VBA, and charts through an AI agent. It can inspect or change an Excel workbook. CX Codex +1 105installs claude-tradingview-mcp-autotrading The claude-tradingview-mcp-autotrading is a Claude Code skill connecting an agent to TradingView charts and executing BitGet trades. It checks all strategy conditions before each trade and logs executions to CSV for tax records. CX Codex +1 104installs huolala-figma-mcp huolala-figma-mcp connects an MCP service that translates Figma designs into interface code packages with sliced graphics and intermediate DSL data. CX Codex +1 102installs matlab-mcp-server Skill for executing MATLAB code from AI assistants via Model Context Protocol. Lets agents run calculations, assess code quality, and manage MATLAB sessions. CX Codex +1 102installs blockrun-mcp-live-data The blockrun-mcp-live-data skill connects your agent to real-time cryptocurrency prices, prediction markets, research papers, and X/Twitter data via BlockRun MCP. Pay per query from a USDC wallet—fractions of a cent each. CX Codex +1 100installs codebase-memory-mcp-pro-knowledge-graph codebase-memory-mcp-pro-knowledge-graph is a Claude Code skill that maps a codebase into a syntax-tree graph. Agents find callers, trace call chains, and assess change impact. CX Codex +1 100installs

Project sponsors

Companies that keep this analytics open