← Open Source
tuannvm

codex-mcp-server

MCP server wrapper for OpenAI Codex CLI that enables Claude Code to leverage Codex's AI capabilities directly.

AI EngineeringGive agent toolsTypeScript
Open on GitHub
Momentum
+0stars in 24 hours0.0%
644
Stars
78
Forks
+0
This week
7
Contributors
Created 2025-08-18 · Updated 2026-10-15 · #15606 today
Top developers

tuannvm/codex-mcp-server is ranked 15,606 with 644 stars.

Same-category comparison

tuannvm/codex-mcp-server is ranked 15,606 among these 8 peers; aorwall/moatless-tools is ranked 15,615.

Same-category comparison
NameRankMetrics
huchenlei/ComfyUI-IC-Light-Native15,585
Language:
Python
Stars:
645
Forks:
36
Description:
ComfyUI native implementation of IC-Light.
lofcz/LLMTornado15,587
Language:
C#
Stars:
645
Forks:
119
Description:
The . NET library to build AI agents with 30+ built-in connectors.
v4rl-ucy/ccm_slam15,591
Language:
C++
Stars:
645
Forks:
111
Description:
CCM-SLAM: Robust and Efficient Centralized Collaborative Monocular SLAM for Robotic Teams.
CY-CHENYUE/ComfyUI-Janus-Pro15,594
Language:
Python
Stars:
644
Forks:
80
Description:
ComfyUI nodes for Janus-Pro, a unified multimodal understanding and generation framework.
aorwall/moatless-tools15,615
Language:
Python
Stars:
643
Forks:
61
featureform/enrichmcp15,617
Language:
Python
Stars:
643
Forks:
32
Description:
EnrichMCP is a python framework for building data driven MCP servers.
Arvincreator/project-golem15,637
Language:
JavaScript
Stars:
641
Forks:
106
Description:
OS-level autonomous AI agent with long-term memory, multi-agent coordination, Titan Chronos scheduler & Moltbot Social Core.
BUAADreamer/EasyRAG15,638
Language:
Python
Stars:
641
Forks:
78
Key parameters and specifications
Key parameters and specifications
ParameterValue
LanguageTypeScript
CategoryAI Engineering
SubcategoryGive agent tools
KeywordsClient integration, Coding, MCP
Stars644
Forks78
Contributors7
Created date2025-08-18
Updated date2026-10-15
Stars in 1 day0
Stars in 7 days0
Rank15,606
Previous rank6,703
Rank change-8,903
7-day stars rank15,081
Previous 7-day stars rank15,084
7-day stars rank change3
Total stars rank15,893
Previous total stars rank15,851
Total stars rank change-42
Frequently asked questions

How many stars and forks are recorded?

tuannvm/codex-mcp-server has 644 stars and 78 forks.

What is the repository rank?

tuannvm/codex-mcp-server is ranked 15,606.

What language and category are recorded?

tuannvm/codex-mcp-server has 644 stars, uses TypeScript and belongs to AI Engineering.

Which repository is closest in rank?

tuannvm/codex-mcp-server is compared with aorwall/moatless-tools, ranked 15,615 with 643 stars.

README

Codex MCP Server

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

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

Nearby in the ranking
Similar items