codex-mcp

An MCP server that wraps the Codex CLI (codex exec) for use in Claude Code — with sync calls and async tasks.

Prerequisites

You need the Codex CLI installed and configured:

npm install -g @openai/codex
codex login

Quick Install

One-liner that installs the MCP server and the discuss-with-multi-codex skill:

curl -sSL https://raw.githubusercontent.com/xyzhang626/codex-mcp/main/install.sh | bash

Or manually:

claude mcp add codex -s user -- uvx --from git+https://github.com/xyzhang626/codex-mcp codex-mcp

Then restart Claude Code.

Tools

codex_exec

Synchronous call — send a prompt to codex exec, wait for the response.

codex_async

Submit a prompt asynchronously. Returns a task_id immediately.

codex_poll

Poll an async task by task_id to get the result.

codex_list_tasks

List all async tasks and their statuses.

Configuration

Codex CLI uses its own config at ~/.codex/config.toml (model, API keys, etc.).