Skip to main content
Glama

mcp-codexreview

npm version License: MIT

MCP server that runs OpenAI Codex CLI (codex exec) to review git changes. Any MCP client (Claude Code, etc.) can request a Codex-powered code review of unstaged, staged, or last-commit changes.

Prerequisites

  • Node.js 18+

  • @openai/codex CLI installed and available on $PATH

  • Codex configured with an API key (via ~/.codex/config.toml or environment)

Related MCP server: codex-code-review

Installation

Claude Code

claude mcp add codexreview -- npx -y mcp-codexreview

Claude Desktop

Add to your Claude Desktop configuration (claude_desktop_config.json):

{
  "mcpServers": {
    "codexreview": {
      "command": "npx",
      "args": ["-y", "mcp-codexreview"]
    }
  }
}

Install from Source

git clone https://github.com/signal-slot/mcp-codexreview.git
cd mcp-codexreview
npm install
npm run build
claude mcp add codexreview -- node /path/to/mcp-codexreview/build/index.js

MCP Tools

review_changes

Run Codex to review git changes. Codex reads the diff and provides a thorough code review.

Parameter

Type

Required

Description

type

"unstaged" | "staged" | "last_commit"

yes

Which changes to review

cwd

string

no

Git repo path (default: server working directory)

model

string

no

Override Codex model (e.g. "o3", "gpt-4.1")

instructions

string

no

Additional review focus or instructions

get_diff

Get raw git diff output without invoking Codex.

Parameter

Type

Required

Description

type

"unstaged" | "staged" | "last_commit"

yes

Which changes to diff

path

string

no

Filter to specific file or directory

cwd

string

no

Git repo path

get_changed_files

List changed files with their status (M/A/D/R).

Parameter

Type

Required

Description

type

"unstaged" | "staged" | "last_commit"

yes

Which changes to list

cwd

string

no

Git repo path

How It Works

The review_changes tool spawns codex exec with:

  • -C <cwd> to target the git repo

  • -s read-only sandbox (Codex can read files and run git, but cannot modify)

  • -a on-failure for non-interactive execution

  • --output-last-message <tmpfile> to capture the review text

  • --color never for clean output

The review prompt instructs Codex to run the appropriate git diff command and provide a code review covering correctness, style, performance, security, and improvement suggestions.

License

MIT

Available Tools

3 tools
get_changed_filesA

List files. For git repos lists changed files; for plain directories lists all source files as added.

Inputs: cwd, type.

get_diffA

Get diff output. For git repos returns git diff; for plain directories returns file contents in unified diff format.

Inputs: cwd, path, type.

review_changesA

Review code using OpenAI Codex. Works with git repos (reviews diff) or plain directories (reviews all source files).

Inputs: cwd, type, model, instructions.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.1/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: reviewing code, retrieving the diff, and listing changed files. There is no overlap that would confuse an agent.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern: review_changes, get_diff, get_changed_files. The naming is uniform and predictable.

    Tool Count5/5

    Three tools is well-scoped for a code review server, covering the essential workflow without unnecessary bloat. Each tool earns its place.

    Completeness5/5

    The tool set provides a complete workflow: identify changed files, retrieve the diff, and review the changes. No critical operations are missing for the stated purpose.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Enables code review operations on GitHub and GitLab, including fetching pull/merge requests, viewing diffs, adding comments, analyzing code quality, and creating merge requests directly from your MCP client.
      15
      29 npm
      4
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Exposes functions to get the current working directory and review git diffs before commit as MCP tools, leveraging Claude Code CLI for diff review.
      -