Codex MCP Server

--- layout: home hero: name: 'Codex MCP Tool' text: 'Connect the Codex CLI to the MCP Ecosystem' tagline: "Leverage OpenAI's Codex models in any client that supports the standardized MCP protocol—<span style='color: #FFFFFF; background-color: #D97706; padding: 2px 8px; border-radius: 6px; font-size: 14px; font-weight: 600; margin-left: 4px; display: inline-block; vertical-align: middle;'>built for Claude Code</span>" actions: - theme: brand text: Get Started link: /getting-started - theme: alt text: Leave a Star ⭐ link: https://github.com/x51xxx/codex-mcp-tool features: - icon: 📂 title: Natural File Analysis details: | <span class="diff-line diff-delete">@filename integration lets you</span><br> <span class="diff-line diff-add">analyze any codebase with ease.</span> - icon: 🤖 title: Native Codex Integration details: Direct access to GPT-5 and other OpenAI models through Codex CLI. - icon: 🤝 title: Claude's coding partner details: Let Claude use Codex naturally for complex code analysis and generation. - icon: 🔌 title: MCP Standards details: | <span style="color: #3b82f6;">Built on MCP protocol.</span><br><span style="color: #ef4444;">Tested with MCP standard.</span><br><span style="color: #22c55e;"><em>Benchmarked</em> with <span style="color: #f97316;">Claude Code</span>.</span> - icon: 🔐 title: Secure by Design details: Uses your existing Codex CLI authentication. No extra keys needed. - icon: 🚦 title: Advanced Controls details: Full support for sandbox modes, approval policies, and model selection. --- <div class="explore-hint" style="text-align: center; margin: 32px 0 48px; position: relative;"> <div class="explore-dots" style="display: inline-flex; align-items: center; gap: 4px;"> <span class="dot" style="font-size: 11px; letter-spacing: 0.5px; color: var(--vp-c-text-3); opacity: 0.8; transition: all 0.3s ease;">•</span> <span class="dot" style="font-size: 11px; letter-spacing: 0.5px; color: var(--vp-c-text-3); opacity: 0.8; transition: all 0.3s ease; transition-delay: 0.1s;">•</span> <span class="dot" style="font-size: 11px; letter-spacing: 0.5px; color: var(--vp-c-text-3); opacity: 0.8; transition: all 0.3s ease; transition-delay: 0.2s;">•</span> </div> <p class="explore-text" style="font-size: 13px; color: var(--vp-c-text-3); margin-top: 8px; opacity: 0.7; transition: all 0.3s ease;"> And much more to explore </p> </div> <div style="margin-top: 48px;"> ## What is Codex MCP Tool? </div> Codex MCP Tool is a Model Context Protocol (MCP) server that bridges the gap between OpenAI's powerful Codex CLI and the growing ecosystem of MCP-compatible clients. It allows AI assistants like Claude to leverage Codex's advanced code analysis and generation capabilities through a standardized protocol. ### Key Features - **🚀 Non-Interactive Execution**: Runs `codex exec` commands programmatically - **📁 File Reference Support**: Use `@` syntax to include files in your prompts - **🔒 Sandbox Modes**: Choose from read-only, workspace-write, or full access - **✅ Approval Policies**: Control when human approval is needed - **🎯 Model Selection**: Choose between GPT-5 and other available models - **📊 Progress Tracking**: Real-time updates for long-running operations - **🔄 Change Mode**: Structured edit suggestions with OLD/NEW format ### Use Cases - **Code Analysis**: Understand complex codebases with deep AI insights - **Security Reviews**: Find vulnerabilities and get remediation suggestions - **Code Generation**: Create new features with context-aware code generation - **Refactoring**: Modernize legacy code with intelligent suggestions - **Documentation**: Generate comprehensive docs from your codebase - **Testing**: Create unit tests that actually understand your code <div style="margin-top: 48px;"> ## Quick Start </div> ### For Claude Code Users ```bash # One-command installation claude mcp add codex-cli -- npx -y codex-mcp-tool codex-mcp # Verify installation /mcp ``` ### For Claude Desktop Users Add to your configuration file: ```json { "mcpServers": { "codex-cli": { "command": "npx", "args": ["-y", "codex-mcp-tool", "codex-mcp"] } } } ``` For detailed installation and setup instructions, see our [Getting Started Guide](/getting-started). ### Example Commands Once installed, you can use natural language or slash commands: ``` // Natural language "use codex to analyze @src/main.ts and explain what it does" "ask codex to find security vulnerabilities in this codebase" "have codex refactor this function to use modern JavaScript" // Slash commands (Claude Code) /codex-cli:analyze @README.md summarize this file /codex-cli:sandbox create a Python data processing script ``` <div style="margin-top: 48px;"> ## Documentation </div> - [Getting Started](/getting-started) - Installation and setup guide - [Codex CLI Usage](/codex-cli-getting-started) - Learn about the underlying Codex CLI - [Configuration](/config) - Advanced configuration options - [Sandbox Modes](/sandbox) - Understanding execution environments - [Authentication](/authentication) - Setting up Codex CLI authentication <div style="margin-top: 48px;"> ## Community & Support </div> - **GitHub**: [x51xxx/codex-mcp-tool](https://github.com/x51xxx/codex-mcp-tool) - **Issues**: [Report bugs or request features](https://github.com/x51xxx/codex-mcp-tool/issues) - **Discussions**: [Join the conversation](https://github.com/x51xxx/codex-mcp-tool/discussions) ## Acknowledgments This project was inspired by the excellent work from [jamubc/gemini-mcp-tool](https://github.com/jamubc/gemini-mcp-tool). Special thanks to [@jamubc](https://github.com/jamubc) for the original MCP server architecture and implementation patterns. <div style="margin-top: 48px;"> ## License </div> This project is licensed under the MIT License. See the [LICENSE](https://github.com/x51xxx/codex-mcp-tool/blob/main/LICENSE) file for details. **Disclaimer:** This is an unofficial, third-party tool and is not affiliated with, endorsed, or sponsored by OpenAI.