openai-codex-mcp
@agency-ai-solutions
About openai-codex-mcp
An MCP server to communicated with, use, and wrap the API for the OpenAI Codex CLI tool.
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"openai-codex-mcp": {
"command": "uv",
"args": [
"venv",
"#",
"creates",
"a",
".venv/",
"directory"
]
}
}
}Tools
No tools detected
We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.
Overview
What is openai-codex-mcp?
openai-codex-mcp is a JSON-RPC server that wraps the OpenAI Codex CLI tool, enabling Claude Code to use OpenAI’s models for code generation, explanation, and debugging within the same interface.
How to use openai-codex-mcp?
Install with uv pip install . after creating a venv, then run codex_server (or uvicorn codex_server:app). Register it in Claude Code via claude mcp add /path/to/openai_codex_mcp.json or manually with base URL http://localhost:8000/ and protocol JSON-RPC 2.0. No authentication needed.
Key features of openai-codex-mcp
- Specialized methods:
write_code,explain_code,debug_code - Supports multiple OpenAI models (O‑series and GPT)
- Simplified parameter naming for easy integration
- Runs as a lightweight, standalone Python server
- No authentication required for the MCP server itself
Use cases of openai-codex-mcp
- Generate code in a specific language for a given task
- Obtain detailed explanations of how code works
- Find and fix bugs in problematic code
- Leverage different OpenAI models (o4‑mini, gpt‑4o, etc.) for specialized tasks
FAQ from openai-codex-mcp
What makes this MCP server different from directly using the Codex CLI?
It provides a JSON-RPC interface specifically designed for Claude Code, with dedicated methods for common coding tasks and simplified parameter naming.
What are the runtime requirements?
Python 3.12+, the OpenAI Codex CLI tool (installed via npm install -g @openai/codex), and a valid OpenAI API key configured for the Codex CLI.
Where does the code/data processed by the server live?
The README does not specify data storage; all processing occurs locally via the Codex CLI and the MCP server on localhost.
Does the server support authentication?
No – the base URL configuration does not require an authentication token.
What transport protocol does it use?
JSON-RPC 2.0 over HTTP, listening on port 8000 by default.
Frequently asked questions
What makes this MCP server different from directly using the Codex CLI?
It provides a JSON-RPC interface specifically designed for Claude Code, with dedicated methods for common coding tasks and simplified parameter naming.
What are the runtime requirements?
Python 3.12+, the OpenAI Codex CLI tool (installed via `npm install -g @openai/codex`), and a valid OpenAI API key configured for the Codex CLI.
Where does the code/data processed by the server live?
The README does not specify data storage; all processing occurs locally via the Codex CLI and the MCP server on localhost.
Does the server support authentication?
No – the base URL configuration does not require an authentication token.
What transport protocol does it use?
JSON-RPC 2.0 over HTTP, listening on port 8000 by default.
Basic information
More AI & Agents MCP servers
MCP Claude Code
SDGLBLMCP implementation of Claude Code capabilities and more
Model Context Protocol for Unreal Engine
chongdashuEnable AI assistant clients like Cursor, Windsurf and Claude Desktop to control Unreal Engine through natural language using the Model Context Protocol (MCP).
21st.dev Magic AI Agent
21st-devIt's like v0 but in your Cursor/WindSurf/Cline. 21st dev Magic MCP server for working with your frontend like Magic
🛡️ A.I.G（AI-Infra-Guard）
TencentA full-stack AI Red Teaming platform securing AI ecosystems via OpenClaw Security Scan, Agent Scan, Skills Scan, MCP scan, AI Infra scan and LLM jailbreak evaluation.
1MCP - One MCP Server for All
1mcp-appA unified Model Context Protocol server implementation that aggregates multiple MCP servers into one.
Comments