# codex-mcp-server-integration

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.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 171 installs · ★ 9 repo stars
- Author: reason-machines
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/codex-mcp-server-integration/SKILL.md
- Updated: 2026-10-09
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/skills/codex-mcp-server-integration

## What it 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.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill codex-mcp-server-integration -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/codex-mcp-server-integration/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/codex-mcp-server-integration/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill codex-mcp-server-integration -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/codex-mcp-server-integration/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill codex-mcp-server-integration -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/codex-mcp-server-integration/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install reason-machines/mcp-skills skills/codex-mcp-server-integration
```

2. **Manually: put the files in place**
- File: `.github/skills/codex-mcp-server-integration/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill codex-mcp-server-integration -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/reason-machines/mcp-skills --path skills/codex-mcp-server-integration
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/codex-mcp-server-integration/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add reason-machines/mcp-skills --skill codex-mcp-server-integration -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/reason-machines/mcp-skills/tree/HEAD/skills/codex-mcp-server-integration/SKILL.md

## When to use it
- 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
- Analyze `src/auth/login.ts` with 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`

## Similar
- [arize-ai-provider-integration](https://affpapa.org/en/nevibecode/skills/arize-arize-ai-provider-integration.md) — skill · 3300 installs
- [oracle](https://affpapa.org/en/nevibecode/skills/oracle.md) — skill · 5200 installs
- [codex-review](https://affpapa.org/en/nevibecode/skills/jezweb-codex-review.md) — skill · 579 installs
- [codex](https://affpapa.org/en/nevibecode/skills/hermes-agent-codex.md) — skill · 445 installs
- [codex-skill](https://affpapa.org/en/nevibecode/skills/codex-skill.md) — skill · 416 installs
- [local-codex](https://affpapa.org/en/nevibecode/skills/local-codex.md) — skill · 412 installs

From the same set: [reason-machines/mcp-skills](https://affpapa.org/en/nevibecode/by/reason-machines/mcp-skills.md) — 98 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
