by tuannvm
MCP server wrapper for OpenAI Codex CLI that enables Claude Code to leverage Codex's AI capabilities directly.
# Add to your Claude Code skills
git clone https://github.com/tuannvm/codex-mcp-serverBridge between Claude and OpenAI's Codex CLI — get AI-powered code analysis, generation, and review right in your editor.
graph LR
A[Claude Code] --> B[Codex MCP Server]
B --> C[Codex CLI]
C --> D[OpenAI API]
style A fill:#FF6B35
style B fill:#4A90E2
style C fill:#00D4AA
style D fill:#FFA500
npm i -g @openai/codex
codex login --api-key "your-openai-api-key"
claude mcp add codex-cli -- npx -y codex-mcp-server
Ask codex to explain this function
Use codex to refactor this code for better performance
Use review to check my uncommitted changes
| Tool | Description |
|------|-------------|
| codex | AI coding assistant with session support, model selection, and structured output metadata |
| 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 |
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
Passing a sessionId creates the session on first use, so listSessions will show it (for this server instance) and subsequent calls can resume context.
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 comple...