1. Conduid
  2. Developer Tools
  3. codex-server
MCP server · Developer Tools

codex-server

by · github.com/tuannvm/codex-mcp-server

MCP server wrapper for OpenAI Codex CLI

Unclaimed devtools
InstallView source
39Low

Scored 5 months ago · breakdown

About codex-server

codex-server is an MCP server published by git+tuannvm in the Developer Tools category: mCP server wrapper for OpenAI Codex CLI.

Install

Install
npx codex-mcp-server
Claude Code
claude mcp add codex-mcp-server-gittuann -- npx -y codex-mcp-server
npx
npx -y codex-mcp-server

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (6)

codexAI coding assistant with session support, model selection, and structured output metadata

Parameters not published.

helpGet Codex CLI help

Parameters not published.

listSessionsView active conversation sessions

Parameters not published.

pingTest server connection

Parameters not published.

reviewAI-powered code review for uncommitted changes, branches, or commits

Parameters not published.

websearchWeb search using Codex CLI with customizable result count and search depth

Parameters not published.

Ask AI

✦

Ask AI about codex-server

Powered by Claude · Grounded in docs

I know everything about codex-server. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.
  • !Scoped permissionsDoesn't declare a permission scope. Assume it can do anything its process can.

4 checks have not been run yet.

README

Codex MCP Server

npm version npm downloads license

Bridge between Claude and OpenAI's Codex CLI — get AI-powered code analysis, generation, and review right in your editor.

graph LR
    A[Claude Code] --> B[Codex MCP Server]
    B --> C[Codex CLI]
    C --> D[OpenAI API]

    style A fill:#FF6B35
    style B fill:#4A90E2
    style C fill:#00D4AA
    style D fill:#FFA500

Quick Start

1. Install Codex CLI

npm i -g @openai/codex
codex login --api-key "your-openai-api-key"

2. Add to Claude Code

claude mcp add codex-cli -- npx -y codex-mcp-server

3. Start Using

Ask codex to explain this function
Use codex to refactor this code for better performance
Use review to check my uncommitted changes

One-Click Install

VS Code VS Code Insiders Cursor

Tools

Tool Description
codex AI coding assistant with session support, model selection, and structured output metadata
review AI-powered code review for uncommitted changes, branches, or commits
websearch Web search using Codex CLI with customizable result count and search depth
listSessions View active conversation sessions
ping Test server connection
help Get Codex CLI help

Examples

Code analysis:

Use codex to analyze this authentication logic for security issues

Multi-turn conversations:

Use codex with sessionId "refactor" to analyze this module
Use codex with sessionId "refactor" to implement your suggestions

Passing a sessionId creates the session on first use, so listSessions will show it (for this server instance) and subsequent calls can resume context.

Code review:

Use review with base "main" to check my PR changes
Use review with uncommitted true to review my local changes

Advanced options:

Use codex with model "o3" and reasoningEffort "high" for complex analysis
Use codex with fullAuto true and sandbox "workspace-write" for automated tasks
Use codex with callbackUri "http://localhost:1234/callback" for static callbacks
Use codex to return structuredContent with threadId metadata when available

Web search:

Use websearch with query "TypeScript 5.8 new features"
Use websearch with query "Rust vs Go performance 2025" and numResults 15
Use websearch with query "React Server Components" and searchDepth "full"

Requirements

  • Codex CLI v0.75.0+ — Install with npm i -g @openai/codex or brew install codex
  • OpenAI API key — Run codex login --api-key "your-key" to authenticate

Codex 0.87 Compatibility

  • Thread ID + structured output: When Codex CLI emits threadId, this server returns it in content metadata and structuredContent, and advertises an outputSchema for structured responses.

Documentation

Environment Variables

  • CODEX_MCP_CALLBACK_URI: Static MCP callback URI passed to Codex when set (overridden by callbackUri tool arg)

Development

npm install    # Install dependencies
npm run dev    # Development mode
npm run build  # Build for production
npm test       # Run tests

Related Projects

  • gemini-mcp-server — MCP server for Gemini CLI with 1M+ token context, web search, and media analysis
  • Clotch — Dynamic Island for Claude Code on macOS — monitor sessions across multiple machines and providers in real time

License

ISC

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About codex-server

How do I install codex-server?

Run npx codex-mcp-server, then add the server to your MCP client's configuration.

Is codex-server safe to use with an AI agent?

Its trust score is 39 out of 100 (low). It passes 1 of the 2 static security checks run so far; the failures are listed above. It has no ConduID identity yet, so agent calls to it are not receipted.

Is codex-server still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.