Codex MCP Toolは、IDEやAIアシスタント(Claude、カーソルなど)をCodex CLIに接続するオープンソースのModel Context Protocol(MCP)サーバーです。codex execによる非インタラクティブな自動化、承認による安全なサンドボックス編集、@ファイル参照による大規模なコード解析を可能にします。信頼性と速度を重視して構築されており、進捗更新をストリーミングし、構造化変更モード(OLD/NEWパッチ出力)をサポートし、標準MCPクライアントとクリーンに統合してコードレビュー、リファクタリング、ドキュメント、CI自動化を実現します。

最新リリース(v1.2.4):Windows互換性の向上 - 現在はクロススポーンを使用し、Windows、macOS、Linuxのすべてのプラットフォームで信頼性の高いnpmグローバルコマンド実行を実現しました。変更履歴を参照

• MCPクライアントにCodexの質問をしたり、プログラム的にアイデアをブレインストーミングしたりする。

要約:+ Codex CLI

目標:MCP対応エディターからCodexを直接使い、コードを効率的に分析・編集すること。

前提条件

このツールを使用する前に、以下の条件を満たしてください:

1. Node.js(v18.0.0以上)
2. Codex CLIのインストールおよび認証

** ✅ クロスプラットフォームサポート**:Windows、macOS、Linux(v1.2.4+)で完全にテストされ動作中

ワンラインセットアップ

Codex MCP Tool

Codex MCP Tool is an open‑source Model Context Protocol (MCP) server that connects your IDE or AI assistant (Claude, Cursor, etc.) to the Codex CLI. It enables non‑interactive automation with codex exec, safe sandboxed edits with approvals, and large‑scale code analysis via @ file references. Built for reliability and speed, it streams progress updates, supports structured change mode (OLD/NEW patch output), and integrates cleanly with standard MCP clients for code review, refactoring, documentation, and CI automation.

Latest Release (v1.2.4): Enhanced Windows compatibility - Now using cross-spawn for reliable npm global command execution across all platforms (Windows, macOS, Linux). See changelog

• Ask Codex questions from your MCP client, or brainstorm ideas programmatically.

TLDR: + Codex CLI

Goal: Use Codex directly from your MCP-enabled editor to analyze and edit code efficiently.

Prerequisites

Before using this tool, ensure you have:

1. Node.js (v18.0.0 or higher)
2. Codex CLI installed and authenticated

✅ Cross-Platform Support: Fully tested and working on Windows, macOS, and Linux (v1.2.4+)

One-Line Setup

claude mcp add codex-cli -- npx -y @cexll/codex-mcp-server

Verify Installation

Type /mcp inside Claude Code to verify the Codex MCP is active.

---

Alternative: Import from Claude Desktop

If you already have it configured in Claude Desktop:

1. Add to your Claude Desktop config:

"codex-cli": {
  "command": "npx",
  "args": ["-y", "@cexll/codex-mcp-server"]
}

2. Import to Claude Code:

claude mcp add-from-claude-desktop

Configuration

Register the MCP server with your MCP client:

For NPX Usage (Recommended)

Add this configuration to your Claude Desktop config file:

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