codex-mcp-server-integration — Claude Code & Codex skill: what it does
codex-mcp-server-integration — a skill that bridges OpenAI Codex CLI to Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode via MCP. Brings code analysis, generation, branch review, and web search into the editor.
no license 171 installs ★ 9 updated 2026-10-09
npx skills add reason-machines/mcp-skills --skill codex-mcp-server-integration -a claude-codeWhat codex-mcp-server-integration does
The skill runs on six platforms: Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, and OpenCode. It exposes a set of tools through the Model Context Protocol on top of Codex CLI — codex for analysis and generation, review for uncommitted diffs or branch comparisons, websearch for pulling fresh documentation, listSessions to track active conversations, plus ping and help.
The sessionId parameter keeps context across turns: start a session to audit an authentication module, then continue in the same thread to generate tests for the fixes found. The review tool accepts uncommitted, base/head, or commit flags, so checking local edits and reviewing a branch before a PR both go through one call.
Codex CLI 0.75.0 or higher must be installed and authenticated with OPENAI_API_KEY before the MCP server can reach the OpenAI API. The server starts without the key, but every tool call returns an authorization error.
What it helps with
- review uncommitted changes before committing via Codex
- compare a feature branch against main before opening a PR
- search for up-to-date library documentation through the built-in web search
- run a multi-turn refactoring session with persistent context across messages
- generate code autonomously with workspace-write sandbox permissions
Example prompts for the agent
- Analyze
src/auth/login.tswith Codex and suggest security fixes - Review all uncommitted changes using Codex
- Search for the latest Prisma docs with Codex and help migrate
src/models/user.ts
How to install codex-mcp-server-integration
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill codex-mcp-server-integration -a claude-code2Manually: put the files in place
~/.claude/skills/codex-mcp-server-integration/SKILL.mdCopy the whole skill folder; for one project use .claude/skills/codex-mcp-server-integration/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill codex-mcp-server-integration -a codex2Manually: put the files in place
.agents/skills/codex-mcp-server-integration/SKILL.mdFor all projects use ~/.agents/skills/
1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill codex-mcp-server-integration -a cursor2Manually: put the files in place
.cursor/skills/codex-mcp-server-integration/SKILL.mdCursor also reads .agents/skills/ and .claude/skills/
1GitHub CLI
gh skill install reason-machines/mcp-skills skills/codex-mcp-server-integration2Manually: put the files in place
.github/skills/codex-mcp-server-integration/SKILL.md1Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill codex-mcp-server-integration -a gemini-cli2Platform CLI
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/codex-mcp-server-integrationManually: put the files in place
.devin/skills/codex-mcp-server-integration/SKILL.mdThe legacy .windsurf/skills/ path still works
Skills CLI (Vercel)
npx skills add reason-machines/mcp-skills --skill codex-mcp-server-integration -a opencodeClaude.ai
Zip the folder and upload it in Settings → Capabilities → Skills
Step by step, with commands for each platform: How to install skills in Claude Code: five ways
Questions about codex-mcp-server-integration
How do I install codex-mcp-server-integration in Claude Code?
Run npx skills add reason-machines/mcp-skills --skill codex-mcp-server-integration -a claude-code. The skill file will be placed at ~/.claude/skills/codex-mcp-server-integration/SKILL.md.
What does the codex-mcp-server-integration skill do?
It connects Codex CLI to any MCP-compatible editor and adds tools for code analysis, diff review, generation, and web search. The agent calls them directly in response to your prompts.
What does the skill require to work?
Codex CLI 0.75.0 or higher — install with npm install -g @openai/codex or brew install codex — and a valid OPENAI_API_KEY passed via codex login --api-key. Without authentication every tool call fails.