codex-mcp-tool

Overview

Codex MCP Server provides a bridge between Claude/Cursor and the Codex CLI, enabling advanced code analysis through file references (@src/, @package.json), multi-turn conversations with session management, and structured change modes for refactoring. The server supports various models including GPT-5.5 and local OSS models via Ollama or LM Studio. It features sandboxed code execution, web search capabilities, and brainstorming frameworks like SCAMPER.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• ask-codex

  Execute Codex CLI with file analysis, models, sessions

  Try:analyze @src/Try:use codex with model gpt-5.5 to analyze @algorithm.pyTry:ask codex sessionId:"my-project" prompt:"explain @src/"
• brainstorm

  Generate ideas with SCAMPER, design-thinking, etc.

  Try:brainstorm ways to optimize CI/CD using SCAMPER methodTry:generate ideas for improving user experience
• list-sessions

  View/delete/clear conversation sessions

  Try:list all active sessionsTry:delete my-session
• health

  Diagnose CLI installation, version, features

  Try:check system healthTry:use health verbose:true
• ping

  Test connection with Codex CLI

  Try:ping codex serverTry:test connection

Comparable tools

Installation

claude mcp add codex-cli -- npx -y @trishchuk/codex-mcp-tool

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

FAQ

What do I need to install before using this MCP server?

You need Node.js 18+, the Codex CLI installed, and authentication with OpenAI configured. The server works with Claude Desktop.

Can I use local models with this MCP server?

Yes, v1.6.0+ supports local OSS models via Ollama or LM Studio. You need to have Ollama running with a model that supports tool calling.

Compare codex-mcp-tool with