mcp-codexreview
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@mcp-codexreview Review my staged changes"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
mcp-codexreview
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/codexCLI installed and available on$PATHCodex configured with an API key (via
~/.codex/config.tomlor environment)
Related MCP server: codex-code-review
Installation
Claude Code
claude mcp add codexreview -- npx -y mcp-codexreviewClaude 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.jsMCP Tools
review_changes
Run Codex to review git changes. Codex reads the diff and provides a thorough code review.
Parameter | Type | Required | Description |
|
| yes | Which changes to review |
|
| no | Git repo path (default: server working directory) |
|
| no | Override Codex model (e.g. |
|
| no | Additional review focus or instructions |
get_diff
Get raw git diff output without invoking Codex.
Parameter | Type | Required | Description |
|
| yes | Which changes to diff |
|
| no | Filter to specific file or directory |
|
| no | Git repo path |
get_changed_files
List changed files with their status (M/A/D/R).
Parameter | Type | Required | Description |
|
| yes | Which changes to list |
|
| no | Git repo path |
How It Works
The review_changes tool spawns codex exec with:
-C <cwd>to target the git repo-s read-onlysandbox (Codex can read files and run git, but cannot modify)-a on-failurefor non-interactive execution--output-last-message <tmpfile>to capture the review text--color neverfor 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 toolsget_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
Scored across 3 tools
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.
All tool names follow a consistent verb_noun pattern: review_changes, get_diff, get_changed_files. The naming is uniform and predictable.
Three tools is well-scoped for a code review server, covering the essential workflow without unnecessary bloat. Each tool earns its place.
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
Related MCP Connectors
GitHub Copilot MCP: code, repo, PR, workflow tools for AI assistants.
A paid remote MCP for OpenAI Codex agent coordination MCP, built to return verdicts, receipts, usage
AI code review for GitHub PRs with an MCP autofix loop for Claude Code and Cursor
Team memory for AI coding agents and code reviews, reviewed by humans and served over MCP.
Related MCP Servers
- AlicenseBqualityDmaintenanceEnables 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.1529 npm4MIT
- FlicenseBqualityDmaintenanceEnables Codex CLI to perform code reviews on uncommitted changes via an MCP tool, keeping review context separate from the main session.16-
- AlicenseNot gradedqualityDmaintenanceMCP server for reviewing code changes using LLMs, supporting Copilot, Ollama, and OpenAI-compatible endpoints.MIT
- FlicenseNot gradedqualityDmaintenanceExposes functions to get the current working directory and review git diffs before commit as MCP tools, leveraging Claude Code CLI for diff review.-