x51xxx avatar

Codex Mcp Tool

x51xxx/codex-mcp-tool

Bridges Claude to the OpenAI Codex CLI for code analysis using file references like @src/ or @package.json. Exposes ask-codex for queries with model selection (gpt-5.5, gpt-5.4, gpt-5.3-codex), session management for multi-turn conversations, and brainstorm for SCAMPER ideation frameworks. Supports sandbox mode for safe execution, web search for research tasks, and local OSS models via Ollama or LM Studio. The list-sessions tool manages conversation state, while health diagnoses CLI version and feature compatibility. Reach for this when you want Claude to leverage Codex's specialized coding models without leaving your workflow, especially for refactoring sessions or when you need structured OLD/NEW patch output.

GitHub stars
21
tools
14
transport
STDIO
env vars
3
last updated
Mar 13, 2026

Tools

14 tools

Public tool metadata for what this MCP can expose to an agent.

ask-codexExecute Codex CLI with files, models, sessions, and safety controls

Execute Codex CLI with files, models, sessions, and safety controls

No parameter schema in public metadata yet.

batch-codexRun multiple atomic Codex tasks sequentially or concurrently

Run multiple atomic Codex tasks sequentially or concurrently

No parameter schema in public metadata yet.

review-changesRun the native non-interactive Codex review command

Run the native non-interactive Codex review command

No parameter schema in public metadata yet.

do-actExecute, verify with a shell command, and retry fixes

Execute, verify with a shell command, and retry fixes

No parameter schema in public metadata yet.

image-genGenerate or edit images with Codex's built-in image_gen tool

Generate or edit images with Codex's built-in image_gen tool

No parameter schema in public metadata yet.

brainstormGenerate ideas with structured creative frameworks

Generate ideas with structured creative frameworks

No parameter schema in public metadata yet.

list-sessionsView, delete, or clear MCP conversation mappings

View, delete, or clear MCP conversation mappings

No parameter schema in public metadata yet.

list-skillsList skills visible from the selected workspace

List skills visible from the selected workspace

No parameter schema in public metadata yet.

healthDiagnose CLI installation, version, features, and sessions

Diagnose CLI installation, version, features, and sessions

No parameter schema in public metadata yet.

fetch-chunkRetrieve a chunk from cached change-mode output

Retrieve a chunk from cached change-mode output

No parameter schema in public metadata yet.

pingTest the MCP connection

Test the MCP connection

No parameter schema in public metadata yet.

helpReturn current codex --help output

Return current codex --help output

No parameter schema in public metadata yet.

versionReport Codex CLI, Node.js, platform, and package versions

Report Codex CLI, Node.js, platform, and package versions

No parameter schema in public metadata yet.

timeout-testExercise keepalive and timeout behavior

Exercise keepalive and timeout behavior

No parameter schema in public metadata yet.

Sponsors

Configuration

CODEX_MCP_CWD

Override working directory for all tool calls

CODEX_SESSION_TTL_MS

Session time-to-live in milliseconds (default: 86400000 = 24h)

CODEX_MAX_SESSIONS

Maximum concurrent sessions (default: 50)

Readme

Codex MCP Server

GitHub Release npm version npm downloads License: MIT

MCP server connecting Claude/Cursor to Codex CLI. Enables code analysis via @ file references, multi-turn conversations, sandboxed edits, and structured change mode.

Features


View the full README on GitHub

Details

Repository
github.com/x51xxx/codex-mcp-tool
Category
AI & LLM Tools
Package
@trishchuk/codex-mcp-tool
Transport
STDIO
Registry
MCP registry, active

More from x51xxx

Related AI & LLM Tools MCP servers

View all
1bumblebiber avatarhmem — Humanlike Memory for AI Agentsbumblebiber/hmemPersistent 5-level hierarchical memory for AI agents. SQLite-backed, lazy-loaded.20stars
2kirbah avatarKirbah Mcp Youtubekirbah/mcp-youtubeProvide token-optimized, structured YouTube data to enhance your LLM applications. Access efficien…19stars
3tlennon-ie avatarNeuroDock Cognitive Graphtlennon-ie/neurodockA local typed-edge graph of people, projects, and decisions that externalises memory.18stars
4othervibes avatarMcp As A Judgeothervibes/mcp-as-a-judgeMCP as a Judge: a behavioral MCP that strengthens AI coding assistants via explicit LLM evaluations17stars
5agentsafe-ai avatarToolTrust Scanneragentsafe-ai/tooltrust-scannerScans MCP servers for prompt injection, data exfiltration, and privilege escalation.16stars
6pensados avatarSentinelX MCPpensados/sentinelx-cloud-coreOperate Linux, macOS and Windows from your LLM. Every action runs through an auditable allowlist.0stars