Advertise
MCP.so
Sign In

Codex MCP Server

@x51xxx

Repository

Basic information

Category

Developer Tools

License

MIT

Transports

stdio

Author

x51xxx

Submitted by

Тарас Тріщук

About Codex MCP Server

No overview available yet

#codex#codex-cli#openai#claude#cursor#code-review#code-analysis#refactoring

Codex MCP Server config

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

{
  "mcpServers": {
    "codex-cli": {
      "command": "npx",
      "args": [
        "-y",
        "@trishchuk/codex-mcp-tool"
      ]
    }
  }
}

Codex MCP Server tools

13

Execute Codex CLI with file analysis (@syntax), skills ($syntax), model selection, and safety controls. Supports changeMode.

Delegate multiple atomic tasks to Codex for batch processing. Ideal for repetitive operations, mass refactoring, and automated code transformations

Run a code review against the current repository using Codex CLI native review subcommand

Echo

receive help information

Display version and system information

Generate creative ideas using structured frameworks with domain context and feasibility analysis.

Retrieves cached chunks from a changeMode response. Use this to get subsequent chunks after receiving a partial changeMode response.

Test timeout prevention by running for a specified duration

List all active conversation sessions with metadata, or manage sessions

Check Codex CLI and session health status

Discover available Codex skills from .agents/skills/ directory

Execute task via Codex, verify with shell command, auto-fix on failure. Act-Check-Fix loop.

Overview

What is Codex MCP Server?

An MCP server that connects Claude or Cursor to Codex CLI, enabling code analysis via @ file references, multi-turn conversations, sandboxed edits, and structured change mode. It is for developers who want to leverage Codex CLI’s capabilities through an MCP-compatible client.

How to use Codex MCP Server?

Install and add via claude mcp add codex-cli -- npx -y @trishchuk/codex-mcp-tool or configure in claude_desktop_config.json. Prerequisites: Node.js 18+ and a working Codex CLI installation (authenticated). Invoke tools like ask-codex, brainstorm, list-sessions, or health.

Key features of Codex MCP Server

  • File analysis with @ file references
  • Multi-turn conversations with workspace isolation
  • Native resume using codex resume (CLI v0.36.0+)
  • Local OSS model support via Ollama or LM Studio
  • Sandboxed code execution with --full-auto
  • Structured brainstorming with SCAMPER framework

Use cases of Codex MCP Server

  • Analyze code architecture by referencing files via @src/
  • Conduct multi-turn code review sessions using session IDs
  • Run untrusted code safely in sandbox mode
  • Generate refactoring ideas with structured brainstorming
  • Use local models for code analysis without sending data to OpenAI

Frequently asked questions

1

What are the runtime dependencies?

Node.js 18+ and a locally installed and authenticated Codex CLI are required.

2

How do I configure multi-turn conversations?

Pass a `sessionId` parameter in your prompt. Sessions persist for 24 hours by default (configurable via `CODEX_SESSION_TTL_MS`), with a maximum of 50 sessions.

3

What models are supported?

By default the CLI’s configured model is used. You can override with model names like `gpt-5.5`, `gpt-5.4`, `gpt-5.4-mini`, or use local OSS models via `localProvider: "ollama"` or `"lmstudio"`.

4

Where does session data live?

Session data is stored locally on your machine under the Codex CLI workspace; no data is sent to external servers except through your chosen model provider.

5

What CLI versions are compatible?

Features work best with Codex CLI v0.36.0+ (sessions), v0.52.0+ (search), and v0.59.0+ (add-dirs, token limits).

Comments

More Developer Tools MCP servers

Codex Pets

astandrik

Public read-only MCP server for discovering, inspecting, installing, and sharing approved Codex-compatible animated pet packs.

screenshotrun-mcp

screenshotrun

Give your AI agent the ability to see any webpage. Capture screenshots from Claude, Cursor, or any MCP client. Supports full-page, dark mode, mobile emulation, OG image generation, base64 output, custom viewport, ad bloc

ShipMyForm

ShipMyForm.com

Form backend for static sites. Create form endpoints, get paste-ready markup for HTML, React, Vue, Svelte and Astro, and read submission stats — straight from your agent. Submissions are spam-filtered, stored, and routed

Modelglass

Modelglass

Modelglass turns "which model should I use?" into a lookup instead of a guess. Seven tools give your agent live pricing across image, language, video, and audio models. Sourced and versioned, not scraped once and forgott

1

Screen Browser

Screen Browser

Turn a plain-language guide into a narrated walkthrough video of your deployed web app. Your coding agent can write the guide from the source and bring back the MP4.

Advertise