codex-mcp-server
MCP server wrapper for OpenAI Codex CLI that enables Claude Code to leverage Codex's AI capabilities directly.
File Explorer
Download Latest Version (.zip)- ci.yml
- release.yml
- changelog-config.json
- dependabot.yml
- api-reference.md
- codex-cli-integration.md
- plan.md
- session-management.md
- TODO.md
- context-building.test.ts
- default-model.test.ts
- edge-cases.test.ts
- error-scenarios.test.ts
- index.test.ts
- mcp-stdio.test.ts
- model-selection.test.ts
- resume-functionality.test.ts
- session.test.ts
- working-directory.test.ts
- storage.ts
- definitions.ts
- handlers.ts
- command.ts
- errors.ts
- index.ts
- server.ts
- types.ts
- .gitignore
- .mcp.json
- .prettierrc
- CLAUDE.md
- eslint.config.mjs
- jest.config.mjs
- Makefile
- package-lock.json
- package.json
- README.md
- tsconfig.json
# Installation Guide
git clone https://github.com/tuannvm/codex-mcp-server
Downloads the entire project code from GitHub to your computer.
cd codex-mcp-server
Moves into the project folder you just downloaded.
2. Official Install Script
Easy Recommended- Node.js Node.js must be installed to use npm.
npm i -g @openai/codex
Installs the package published on the npm registry globally β no need to clone the source.
Pulled directly from this repo's README.
3. Node.js
Easynpm i -g @openai/codex
Installs the package published on the npm registry globally β no need to clone the source.
npm install # Install dependencies
Downloads and installs the libraries listed in package.json.
npm run dev # Development mode
Starts the development/run server.
npm run build # Build for production
Builds optimized production files.
npm test # Run tests
Type this command into your terminal and run it.
Pulled directly from this repo's README.
4. Make
Medium- Git Needed to download the project code from GitHub.
- Make Usually pre-installed on Linux/macOS. On Windows, install separately (e.g. via MSYS2 or WSL).
make
Compiles the code based on the generated build configuration to produce an executable.