claude-code-codex-mcp

# Codex MCP Server for Claude Code This MCP server enables Claude Code to use OpenAI's Codex CLI for multi-agent orchestration. ## Prerequisites 1. **Install Codex CLI**: ```bash npm install -g @openai/codex ``` 2. **Authenticate with OpenAI**: ```bash codex login ``` ## Installation ### Option 1: CLI Command (Recommended) ```bash # User scope (all projects) claude mcp add --transport stdio --scope user codex -- codex mcp-server # Project scope (current project only) claude mcp add --transport stdio --scope project codex -- codex mcp-server ``` ### Option 2: Manual Configuration Add to `~/.claude.json` (user scope) or `.mcp.json` (project scope): ```json { "mcpServers": { "codex": { "type": "stdio", "command": "codex", "args": ["mcp-server"] } } } ``` ## Available Tools | Tool | Description | |------|-------------| | `codex` | Start a new Codex session with a prompt | | `codex-reply` | Continue an existing session using threadId | ## Tool Parameters ### `codex` tool - `prompt` (required): The task description - `approval-policy`: `untrusted`, `on-request`, `on-failure`, `never` - `sandbox`: `read-only`, `workspace-write`, `danger-full-access` - `model`: Override model (e.g., `o3`, `o4-mini`) ### `codex-reply` tool - `threadId` (required): Session ID from previous `codex` call - `prompt` (required): Follow-up message ## Usage Example ``` Use the codex tool to create a Python script that fetches weather data ``` ## Verification ```bash claude mcp list ``` You should see: ``` codex: codex mcp-server - ✓ Connected ``` ## Documentation - [OpenAI Codex Agents SDK](https://developers.openai.com/codex/guides/agents-sdk/) - [Claude Code MCP Docs](https://docs.anthropic.com/en/docs/claude-code/mcp)