gemini-reviews-mcp 1.0.0

Gemini PR Reviews MCP server - Fetch Gemini Code Assist reviews from GitHub PRs

Gemini PR Reviews MCP Server

Fetch Gemini Code Assist PR reviews from GitHub. Auto-detects last PR, filters reviews after your last /gemini review comment, and returns raw JSON.

Features

• Auto-Auth — Uses gh CLI token automatically, falls back to GITHUB_TOKEN env var
• Smart Defaults — Auto-detects repository owner and last PR number
• Filtered Reviews — Get only reviews after your last /gemini review comment
• All Comment Types — PR reviews, line comments, and issue comments
• Full Pagination — Handles large PRs with many comments

Quick Start

Claude Code

# If you have gh CLI authenticated, no token needed:
claude mcp add gemini-reviews -- uvx gemini-reviews-mcp

# Or with explicit token:
claude mcp add gemini-reviews \
  -e GITHUB_TOKEN="ghp_your_token" \
  -- uvx gemini-reviews-mcp

Claude Desktop

Add to your config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "gemini-reviews": {
      "command": "uvx",
      "args": ["gemini-reviews-mcp"]
    }
  }
}

If gh CLI is installed and authenticated, no GITHUB_TOKEN env var is needed.

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "gemini-reviews": {
      "command": "uvx",
      "args": ["gemini-reviews-mcp"]
    }
  }
}

Windsurf

Add to Windsurf MCP config:

{
  "mcpServers": {
    "gemini-reviews": {
      "command": "uvx",
      "args": ["gemini-reviews-mcp"]
    }
  }
}

VS Code

Add to your VS Code settings (JSON):

"mcp": {
  "servers": {
    "gemini-reviews": {
      "type": "stdio",
      "command": "uvx",
      "args": ["gemini-reviews-mcp"]
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json:

{
  "mcpServers": {
    "gemini-reviews": {
      "command": "uvx",
      "args": ["gemini-reviews-mcp"]
    }
  }
}

GitHub Copilot

Add to ~/.copilot/mcp-config.json:

{
  "mcpServers": {
    "gemini-reviews": {
      "command": "uvx",
      "args": ["gemini-reviews-mcp"]
    }
  }
}

OpenAI Codex

Add to ~/.codex/config.toml:

[mcp_servers.gemini-reviews]
command = "uvx"
args = ["gemini-reviews-mcp"]

Install from Source

cd gemini-reviews-mcp
pip install -e .

Authentication

The server resolves GitHub authentication in this order:

1. gh CLI (preferred) — If GitHub CLI is installed and authenticated (gh auth login), the token is obtained automatically via gh auth token. No configuration needed.

2. GITHUB_TOKEN env var (fallback) — Set manually if gh CLI is not available:

   # Create a token at https://github.com/settings/tokens with `repo` scope
   export GITHUB_TOKEN="ghp_your_token_here"
   

3. No token — Works for public repos only, with 60 requests/hour rate limit.

Tool

get_gemini_reviews — Fetch Gemini Code Assist PR reviews

Get Gemini Code Assist reviews from a GitHub PR. By default, fetches only reviews after your last /gemini review comment.

Parameter	Type	Required	Description
repo	string	Yes	Repository name (repo) or full path (owner/repo)
pr	integer	No	PR number (uses last PR if omitted)
after_last_review	boolean	No	Only fetch reviews after your last /gemini review comment (default: true)
username	string	No	GitHub username for filtering (defaults to authenticated user)

Usage Examples

# Simplest — auto-detect owner, last PR, filtered reviews
Use get_gemini_reviews for repo MyProject

# Specific PR
Use get_gemini_reviews for repo MyProject pr 42

# Get ALL reviews (not just after last comment)
Use get_gemini_reviews for repo MyProject with after_last_review false

# Full repo path
Use get_gemini_reviews for repo someone/TheirRepo

License

MIT