tuannvm

codex-mcp-server: Use Codex CLI from Claude and MCP Clients

A TypeScript MCP server that connects Claude Code and compatible clients to OpenAI's Codex CLI. It exposes coding, review, and web-search tools for teams that want Codex capabilities inside an MCP-enabled editor.

QuietTypeScriptMCP ServerClaude CodeCoding Agent
View on GitHub Compare
Stars
644
Forks
78
Stars, last 16 days
+1
Last commit
5 months ago
Contributors
7

Our take

Quietno commits in the last 90 days

Health score

35/100

How it is scored
Activity
47
Community
51
Issues
21
Pull requests
21

+1 stars in the last 16 days

  • Releases more often than 77% of the projects we track

This is a focused integration with recent release activity, but its quiet commit history and lack of recent issue closures make ongoing maintenance worth checking before adopting it for critical workflows.

Good fit if

  • You already use Claude Code or another MCP client and have Codex CLI authenticated.
  • You want Codex coding, review, or search tools available through MCP, rather than a standalone coding assistant.
  • You are comfortable with a project whose measured contributor base is not concentrated around one person.

Look elsewhere if

  • You need a tool that does not depend on OpenAI Codex CLI and its API-key authentication.
  • Your workflow requires evidence of active issue resolution or recent code commits before adoption.
All health signals
Last commit2026-05-25 (5 months ago)
Commits, last 90 days0
Releases, last 12 months22 (latest v1.4.10, 2026-04-10)
Contributors7 (top contributor: 46% of commits)
Issues closed, last 90 days0
Pull requests merged, last 90 days0
Project age14 months

Checked on 2026-10-09 with the GitHub API.

Overview

codex-mcp-server bridges MCP clients such as Claude Code to the OpenAI Codex CLI. It lets a client invoke Codex for code analysis, generation, and review without switching out of its editor workflow.

The server is a fit for developers who already use Codex CLI and want to make its capabilities available through MCP. It passes work to the CLI, so Codex CLI installation and OpenAI authentication are prerequisites rather than features provided by the server itself.

Key Features

  • Provides a codex tool for coding assistance, with session support, model selection, and structured output metadata.
  • Resumes multi-turn work using a session ID, or starts a session on first use.
  • Reviews uncommitted changes, branches, or commits with the review tool.
  • Offers websearch through Codex CLI, with configurable result count and search depth.
  • Includes listSessions, ping, and help tools for session visibility, connectivity checks, and CLI help.
  • Supports options such as model, reasoning effort, sandbox, and full-auto mode.
  • Can return Codex thread IDs in response metadata and structured content when available.

Use Cases

  • Claude Code users who want Codex to explain or analyze code in their current workflow.
  • Developers seeking a second coding assistant to suggest or apply refactors through Codex CLI.
  • Contributors who want Codex to review local uncommitted changes or changes against a base branch.
  • MCP client users who want to run Codex-backed web searches alongside coding tasks.

What you need

Detected in the repository

  • Node.js (from package.json)
  • Automated checks on GitHub Actions

Getting Started

Install and authenticate Codex CLI, then register the server with Claude Code:

npm i -g @openai/codex
codex login --api-key "your-openai-api-key"
claude mcp add codex-cli -- npx -y codex-mcp-server

See the repository README for client setup options and documentation links.

License in Plain Words

No standard license was detected. Without a license, the default copyright rules apply: you may read the code, but not reuse it. Check the repository or ask the authors.

Alternatives

  • codex-plugin-cc: This Claude Code plugin delegates reviews and tasks to the local Codex CLI, rather than exposing Codex tools through an MCP server.
ProjectLanguageLicenseStarsStatus
codex-mcp-serverTypeScript–644Quiet
codex-plugin-ccJavaScriptApache-2.033.8kQuiet

Considerations

  • The server requires Node.js, Codex CLI v0.75.0 or later, and an OpenAI API key. Codex CLI must be installed and logged in separately.
  • Measured health is marked Quiet: there have been no commits in the last 90 days, and no issues were closed in that period. The project has continued to publish releases during the past year, so release activity and commit activity differ.
  • The repository metadata indicates CI is configured, but does not indicate a test suite.
  • The README identifies the license as ISC. Review its terms for your intended use and distribution.

Found this useful?

Share it with someone who would like codex-mcp-server.

Comparisons

codex-plugin-cc vs codex-mcp-server