Codex MCP Wrapper

@teabranch

Repository Homepage

Basic information

About Codex MCP Wrapper

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

#codex #mcp-server#openai-codex-cli

Codex MCP Wrapper config

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

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

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

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

More Developer Tools MCP servers

Eddyter AI Rich Text Editor MCP

EddyterAI

Set up and manage the Eddyter AI rich text editor by talking to your AI agent — for Claude, Cursor, Codex and other MCP tools. A Model Context Protocol server that lets AI tools add Eddyter to a React, Next.js, Vite or R

Yocoolab

MCP server for AI Agents — exposes Yocoolab feedback threads and design selections as tools

Capgo MCP

Cap-go

Console, Backend and CLI to manage Capgo Instant update and Native build for Capacitor apps Build and upload to app store your mobile app

Cronwatch

cronwatchdev

CronWatch records every run of your scheduled jobs in your own database, and speaks up when one is missed, fails, gets stuck, runs slow or costs too much. CronWatch is free and open-source.

Vibgrate MCP

Vibgrate

Query your team's drift, vulnerability, and migration data from any AI assistant. Vibgrate MCP connects Cursor, Claude, ChatGPT, Windsurf, or VS Code to Vibgrate Cloud: 51 tools for DriftScores, CVEs and EOL runtimes, up