codex-mcp-server

MCP server that wraps the Codex CLI so other AI agents can use it as a tool.

Tools

codex_exec

Run Codex non-interactively with a prompt. Codex can read/write files, run shell commands, and perform complex software engineering tasks.

codex_review

Run code reviews using Codex. Supports reviewing against a base branch, specific commits, or uncommitted changes.

Setup

npm install
npm run build

Usage

With Claude Code

Add to your Claude Code MCP config (~/.claude/settings.json or project .mcp.json):

{
  "mcpServers": {
    "codex": {
      "command": "node",
      "args": ["/path/to/codex-mcp-server/dist/index.js"]
    }
  }
}

With any MCP client (stdio)

node dist/index.js

Prerequisites

• Codex CLI installed and authenticated (codex login)
• Node.js >= 18