About Codex MCP Server
Codex MCP Server is an MCP server published by tuannvm in the Developer Tools category: mCP server wrapper for OpenAI Codex CLI that enables Claude Code to leverage Codex's AI capabilities directly.
The repository has 646 stars and 78 forks, with the last commit 5 months ago. Recent commit activity is the strongest signal that reported issues will get attention.
Install
uvx codex-mcp-serverpip install codex-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Tools (6)
codexAI coding assistant with session support, model selection, and structured output metadata
Parameters not published.
helpGet Codex CLI help
Parameters not published.
listSessionsView active conversation sessions
Parameters not published.
pingTest server connection
Parameters not published.
reviewAI-powered code review for uncommitted changes, branches, or commits
Parameters not published.
websearchWeb search using Codex CLI with customizable result count and search depth
Parameters not published.
Ask AI
Ask AI about Codex MCP Server
Powered by Claude · Grounded in docs
Security checks
Static checks derived from the repository 4 days ago. Heuristics on the source, not an audit.
- ✓README presentThe repository ships documentation.
- !License declaredNo license file. Legally you have no right to use it in a product.
- ✓Tests presentA test suite exists in the repository.
- ✓Dependencies pinnedA lockfile pins dependency versions.
- ✓No dynamic code executionSource scan found no eval, dynamic Function, or shell execution.
- !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.
Releases
README
Codex MCP Server
Bridge 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
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, model selection, and structured output metadata |
review |
AI-powered code review for uncommitted changes, branches, or commits |
websearch |
Web search using Codex CLI with customizable result count and search depth |
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
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 complex analysis
Use codex with fullAuto true and sandbox "workspace-write" for automated tasks
Use codex with callbackUri "http://localhost:1234/callback" for static callbacks
Use codex to return structuredContent with threadId metadata when available
Web search:
Use websearch with query "TypeScript 5.8 new features"
Use websearch with query "Rust vs Go performance 2025" and numResults 15
Use websearch with query "React Server Components" and searchDepth "full"
Requirements
- Codex CLI v0.75.0+ — Install with
npm i -g @openai/codexorbrew install codex - OpenAI API key — Run
codex login --api-key "your-key"to authenticate
Codex 0.87 Compatibility
- Thread ID + structured output: When Codex CLI emits
threadId, this server returns it in content metadata andstructuredContent, and advertises anoutputSchemafor structured responses.
Documentation
- API Reference — Full tool parameters and response formats
- Session Management — How conversations work
- Codex CLI Integration — Version compatibility and CLI details
Environment Variables
CODEX_MCP_CALLBACK_URI: Static MCP callback URI passed to Codex when set (overridden bycallbackUritool arg)
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
- Clotch — Dynamic Island for Claude Code on macOS — monitor sessions across multiple machines and providers in real time
License
ISC
README fetched from the repository 4 days ago. The original is authoritative.