Codex MCP Wrapper

@teabranch

About Codex MCP Wrapper

An MCP server that scales development into controllable agentic, recursive flows, and build a feature from bottom-up

Config

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

{
  "mcpServers": {
    "agentic-developer-mcp": {
      "command": "node",
      "args": [
        "mcp-server.js"
      ]
    }
  }
}

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 Codex MCP Wrapper?

Codex MCP Wrapper wraps OpenAI's Codex CLI as an MCP (Model Context Protocol) server, making it accessible through the TeaBranch/open-responses-server middleware. It is designed for developers who want to integrate Codex’s autonomous coding capabilities into MCP-compatible workflows.

How to use Codex MCP Wrapper?

Install via Docker (recommended) or manually, then run the MCP server using either stdio or SSE transport. Configure tools in an .agent/mcps.json file and invoke them with parameters such as repository URL and prompt text.

Key features of Codex MCP Wrapper

Wraps OpenAI Codex CLI as an MCP server
Supports stdio and SSE transport modes
Provides run_codex and clone_and_write_prompt tools
Clones repositories and runs Codex with custom prompts
Reads system prompt and model ID from .agent/ files
Compatible with the open-responses-server middleware

Use cases of Codex MCP Wrapper

Analyze code from a cloned repository and suggest improvements
Run Codex autonomously on a specific branch and folder
Integrate Codex with MCP-aware agents and workflows
Execute prompt-driven code generation and review tasks

FAQ from Codex MCP Wrapper

What are the requirements to run Codex MCP Wrapper?

Node 22 (specifically version 22.15.1) is required for Codex. The project also uses Node.js, Express, and Python for the MCP server.

How do I install Codex MCP Wrapper?

Clone the repository and run ./start.sh for Docker-based setup, or install dependencies with npm install, install Codex CLI globally, and start the MCP server manually.

What transport protocols are supported?

The MCP server can be run using stdio (default) or SSE transport on a specified port (e.g., --transport sse --port 8000).

What tools does Codex MCP Wrapper provide?

Two tools: run_codex (clones a repo, optionally checks out a branch/folder, and runs Codex with a request) and clone_and_write_prompt (reads configuration from .agent/ files and invokes Codex).

How do I configure MCP tools for Codex?

Place an mcps.json file under the .agent/ directory of your repository. Codex loads this configuration automatically to register available MCP tools.

Frequently asked questions

What are the requirements to run Codex MCP Wrapper?

Node 22 (specifically version 22.15.1) is required for Codex. The project also uses Node.js, Express, and Python for the MCP server.

How do I install Codex MCP Wrapper?

Clone the repository and run `./start.sh` for Docker-based setup, or install dependencies with `npm install`, install Codex CLI globally, and start the MCP server manually.

What transport protocols are supported?

The MCP server can be run using stdio (default) or SSE transport on a specified port (e.g., `--transport sse --port 8000`).

What tools does Codex MCP Wrapper provide?

Two tools: `run_codex` (clones a repo, optionally checks out a branch/folder, and runs Codex with a request) and `clone_and_write_prompt` (reads configuration from `.agent/` files and invokes Codex).

How do I configure MCP tools for Codex?

Place an `mcps.json` file under the `.agent/` directory of your repository. Codex loads this configuration automatically to register available MCP tools.

Comments

Basic information

More Developer Tools MCP servers

Serena

oraios

A powerful MCP toolkit for coding, providing semantic retrieval and editing capabilities - the IDE for your agent

26.2K

MCP-Scan: An MCP Security Scanner

invariantlabs-ai

Security scanner for AI agents, MCP servers and agent skills.

2.8K

BetterBugs

The BetterBugs MCP (Model Context Protocol) enables you to load BetterBugs bug reports (via report links) directly to your preferred AI Agents and developer environments with MCP Client capabilities (such as Cursor, VS C

Air Pipe

airpipe

Build, validate, deploy — HTTP APIs, cron jobs, webhooks and MCP tools — from your AI client.

PuzzleTide Puzzle Generator

Caravaca-Labs

Word search generator, crossword generator, and sudoku generator + solver as a local-first MCP server. 15 deterministic tools: printable PDF puzzle worksheets, themed word banks, and verifiable LLM evals. From the makers