Codex MCP Server

# Codex MCP Server <div align="center"> [![GitHub Release](https://img.shields.io/github/v/release/x51xxx/codex-mcp-tool?logo=github&label=GitHub)](ht

Local serverstdioPython

What is the Codex MCP Server?

Codex MCP Server ![GitHub Release](https://github.co

What it actually does

  • File Analysis — — Reference files with @src/, @package.json syntax
  • Multi-Turn Sessions — — Conversation continuity with workspace isolation
  • Native Resume — — Uses codex resume for context preservation (CLI v0.36.0+)
  • Local OSS Models — — Run with Ollama or LM Studio via localProvider
  • Web Search — — Research capabilities with search: true
  • Sandbox Mode — — Safe automation with explicit sandbox and approval policies

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
ask-codexExecute Codex CLI with files, models, sessions, and safety controls
batch-codexRun multiple atomic Codex tasks sequentially or concurrently
review-changesRun the native non-interactive Codex review command
do-actExecute, verify with a shell command, and retry fixes
brainstormGenerate ideas with structured creative frameworks
list-sessionsView, delete, or clear MCP conversation mappings
list-skillsList skills visible from the selected workspace
healthDiagnose CLI installation, version, features, and sessions
fetch-chunkRetrieve a chunk from cached change-mode output
pingTest the MCP connection
helpReturn current codex --help output
versionReport Codex CLI, Node.js, platform, and package versions
timeout-testExercise keepalive and timeout behavior

How to install the Codex MCP Server

{
  "mcpServers": {
    "codex-mcp-tool": {
      "command": "npx",
      "args": ["-y", "@trishchuk/codex-mcp-tool"],
      "env": {
        "CODEX_CLI_PATH": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

VariableDescriptionRequired
CODEX_CLI_PATHFilesystem location the server is allowed to use.Optional

Example prompts to try

  • “Use Codex to ask-codex.”
  • “Use Codex to batch-codex.”
  • “Use Codex to review-changes.”

Frequently asked questions

Node.js 18+ and a locally installed and authenticated Codex CLI are required.