Codex MCP Server

Bridge between Claude and OpenAI's Codex CLI — get AI-powered code analysis, generation, and review right in your editor.

Quick Start

1. Install Codex CLI

npm i -g @openai/codex
codex login --api-key "your-openai-api-key"

2. Add to Claude Code

claude mcp add codex-cli -- npx -y codex-mcp-server

3. Start Using

Ask codex to explain this function
Use codex to refactor this code for better performance
Use review to check my uncommitted changes

One-Click Install

Tools

Tool	Description
codex	AI coding assistant with session support and model selection
review	AI-powered code review for uncommitted changes, branches, or commits
listSessions	View active conversation sessions
ping	Test server connection
help	Get Codex CLI help

Examples

Code analysis:

Use codex to analyze this authentication logic for security issues

Multi-turn conversations:

Use codex with sessionId "refactor" to analyze this module
Use codex with sessionId "refactor" to implement your suggestions

Code review:

Use review with base "main" to check my PR changes
Use review with uncommitted true to review my local changes

Advanced options:

Use codex with model "o3" and reasoningEffort "high" for complex analysis
Use codex with fullAuto true and sandbox "workspace-write" for automated tasks

Requirements

• Codex CLI v0.75.0+ — Install with npm i -g @openai/codex or brew install codex

• OpenAI API key — Run codex login --api-key "your-key" to authenticate

Documentation

• API Reference — Full tool parameters and response formats

• Session Management — How conversations work

• Codex CLI Integration — Version compatibility and CLI details

Development

npm install    # Install dependencies
npm run dev    # Development mode
npm run build  # Build for production
npm test       # Run tests

Related Projects

• gemini-mcp-server — MCP server for Gemini CLI with 1M+ token context, web search, and media analysis

License

ISC