OpenAI Codex MCP Server

@Tomatio13

Repository

Basic information

About OpenAI Codex MCP Server

An MCP server to wrap the OpenAI Codex CLI for use with Claude Code

#openai-codex#mcp-server #ai-integration

OpenAI Codex MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "openai-codex-mcp-tomatio13": {
      "command": "python",
      "args": [
        "codex_server.py",
        "--mode",
        "stdio"
      ]
    }
  }
}

OpenAI Codex MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

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 Server?

OpenAI Codex MCP Server wraps OpenAI Codex CLI as an MCP (Model Context Protocol) server for integration with Claude. It provides tools to generate, explain, debug, refactor, and secure code using Codex capabilities directly from Claude.

How to use OpenAI Codex MCP Server?

Clone the repository, run ./setup.sh, then start the server using ./run.sh (stdio mode for Claude Desktop) or ./run_sse.sh [port] [host] (SSE mode for Web API). Configure Claude Desktop to use the server by adding an entry with command python /path/to/codex_server.py --mode stdio to the Claude Desktop configuration file. After setup, invoke tools like @openai-codex codex_agent or @openai-codex codex_interactive with relevant parameters.

Key features of OpenAI Codex MCP Server

Provides codex_agent and codex_interactive tools
Supports code generation, explanation, debugging, refactoring
Includes security analysis, test creation, documentation generation
Multimodal support (image input)
Multiple AI provider support (OpenAI, Azure, Gemini, Ollama, etc.)
3‑level automation modes: suggest, auto‑edit, full‑auto
Runs in both stdio and SSE modes

Use cases of OpenAI Codex MCP Server

Generate new code from natural language prompts
Debug and fix bugs in existing codebases
Perform security analysis and apply fixes
Write or improve documentation and tests
Explain complex code sections interactively

Frequently asked questions

What are the prerequisites for using this server?

You need Node.js with `npm install -g @openai/codex`, Python 3.12 or higher, and a `.env` file copied from `.env.example`.

What modes does the server support?

The server supports stdio mode (for Claude Desktop) and SSE mode (for Web API integration).

What tools does the server provide?

Two tools: `codex_agent` (comprehensive Codex features) and `codex_interactive` (interactive sessions).

What approval modes are available?

Three modes: `suggest` (only suggests changes, requires approval), `auto-edit` (automatic file read/write, asks for shell commands), and `full-auto` (full autonomy with network‑disabled sandbox).

How does security work in full‑auto mode?

The server runs `full-auto` mode in a network‑disabled sandbox. File operations are limited to the current working directory, and all shell commands require explicit approval unless in `full-auto` mode.

Comments

More AI & Agents MCP servers

Ranla

Kurtis Tryber

AI growth agent for software businesses. Ranla ships pages that rank on Google, gets your product named in AI answers, replies on Reddit and sends lifecycle email. Ask how growth is going, have Ranla draft the work and a

Sphere Marketplace

dtajitdinov-aris

Sphere is an exchange where AI agents list services and post requests for other agents. Registration is one request, free, with no human approval. The first order is free: sphere_receipt_trial, one per agent per 24 hours

strac-mcp-dlp

strac-io

Detect and redact PII, PHI, PCI and secrets — SSNs, credit cards, passports, API keys and cloud credentials — in text and in local files, using the Strac DLP API. Five tools: redact_text, detect_sensitive_data, detect_fi

OpenZiti / LLM-Gateway

openziti

NetFoundry LLM Gateway is an OpenAI-compatible API proxy that routes requests across multiple LLM providers using zero-trust networking. Zero trust LLM gateway. OpenAI-compatible proxy with semantic routing and load bala

OpenZiti MCP Gateway

openziti

NetFoundry MCP Gateway enables secure, isolated access to Model Context Protocol (MCP) tools across distributed systems without exposing public endpoints. Zero trust gateway for MCP servers. Aggregate, filter, and secure