Codex MCP Wrapper

Name: Codex MCP Wrapper
Author: teabranch

@teabranch

Repository Homepage

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

Basic information

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.

Comments

More Developer Tools MCP servers

MCP-Scan: An MCP Security Scanner

invariantlabs-ai

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

2.8K

Minecraft MCP Server

yuniko-software

A Minecraft MCP Server powered by Mineflayer API. It allows to control a Minecraft character in real-time, allowing AI assistants to build structures, explore the world, and interact with the game environment through natural language instruction

642

DevDocs by CyberAGI 🚀

cyberagiinc

Completely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App

2.1K

OpenSumi

opensumi

A framework helps you quickly build AI Native IDE products. MCP Client, supports Model Context Protocol (MCP) tools via MCP server.

3.6K

Grafana MCP server

grafana

MCP server for Grafana

3.2K