Skip to directory

About Codex CLI

Bridges OpenAI's Codex CLI with structured command execution, brainstorming sessions, and chunked response delivery for code analysis, automated refactoring, and development workflow automation.

What you can use it for

  • developer tools
Connection and setup
Hosting
Local stdio process
Transport
stdio
Endpoint
Local process; no hosted endpoint documented
Authentication
No credentials were configured; the tested read-only tool “ping” succeeded in an isolated environment. Other tools may have additional requirements.

Requirements

  • Node.js 18+
  • The npm package repository matched the repository linked from the public profile.

Setup steps

  1. npx -y @cexll/codex-mcp-server@1.2.5
Tools 8+

The server returned 8 tools in tools/list. Only “ping” was invoked with a synthetic read-only input and succeeded.

  • ask-codex

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

    Parameters: prompt, model, sandbox, fullAuto, approvalPolicy, approval, sandboxMode, yolo, cd, workingDir, changeMode, chunkIndex, chunkCacheKey, image, config, profile, timeout, includeThinking, includeMetadata, search, oss, enableFeatures, disableFeatures
    01
  • batch-codex

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

    Parameters: tasks, model, sandbox, parallel, stopOnError, timeout, workingDir, search, oss, enableFeatures, disableFeatures
    02
  • ping

    Echo

    Parameters: prompt
    03
  • Help

    receive help information

    04
  • version

    Display version and system information

    05
  • brainstorm

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

    Parameters: prompt, model, approvalPolicy, sandboxMode, fullAuto, yolo, cd, methodology, domain, constraints, existingContext, ideaCount, includeAnalysis, search, oss, enableFeatures, disableFeatures
    06
  • fetch-chunk

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

    Parameters: cacheKey, chunkIndex
    07
  • timeout-test

    Test timeout prevention by running for a specified duration

    Parameters: duration
    08

This server’s available tools can vary by account, permissions, or configuration. The list shown is not its full runtime catalog.

Limitations and notes
  • Runtime verification covered one read-only tool call (ping); other listed tools were not individually exercised.
Original sources
  • MCP.Directory public profile

    Name, description, publisher identifier, categories, transport, tool inventory, and install configuration.

  • Linked publisher repository

    Repository URL linked from the public profile; npm package repository metadata matched this GitHub repository.

  • npm registry metadata

    Published package version 1.2.5 checked before launch. Registry repository: git+https://github.com/cexll/codex-mcp-server.git.

  • maintainer repository documentation

    Checked the linked Cexll community MCP wrapper repository; this is distinct from official OpenAI Codex CLI MCP support, and the official codex mcp-server command was removed.

Documentation checked 2026-10-28T00:00:00Z. Connection has not been runtime tested.