Gerrit Code Review MCP Server

Name: Gerrit Code Review MCP Server
Author: team.gaijin

team.gaijin/go-gerrit-mcp

Repository Registry

What is the Gerrit Code Review MCP server?

Capability-gated Gerrit code review tools with opt-in review notifications pushed into the session

How to install Gerrit Code Review

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

GERRIT_URL
required
Base URL of the Gerrit instance
GERRIT_USERNAME
required
Account username for HTTP authentication
GERRIT_TOKEN
required
secret
HTTP password or token of the account
GERRIT_MCP_GROUPS
Comma-separated capability groups to enable: read, comment, transition
GERRIT_MCP_PROJECTS
Comma-separated Gerrit project allowlist confining every operation
GERRIT_MCP_OWN_CHANGES_ONLY
Refuse trail-leaving operations on changes not owned by the authenticated account
GERRIT_MCP_REVIEW_NOTIFICATIONS
Enable review notifications: poll Gerrit for activity on subscribed changes and push it into the agent's session (requires a client with channel support)
GERRIT_MCP_REVIEW_NOTIFICATIONS_POLL_INTERVAL
Poll cadence for subscribed changes, as a Go duration
GERRIT_MCP_REVIEW_NOTIFICATIONS_INCLUDE_OWN
Keep the authenticated account's own activity in review notifications
GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_ACCOUNTS
Comma-separated usernames or numeric account IDs whose activity never becomes a review notification
GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_PATTERNS
Comma-separated regular expressions; matching message or comment text never becomes a review notification

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "go-gerrit-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/gaijinentertainment/go-gerrit-mcp:1.1.3"
      ],
      "env": {
        "GERRIT_URL": "<YOUR_GERRIT_URL>",
        "GERRIT_USERNAME": "<YOUR_GERRIT_USERNAME>",
        "GERRIT_TOKEN": "<YOUR_GERRIT_TOKEN>",
        "GERRIT_MCP_GROUPS": "<YOUR_GERRIT_MCP_GROUPS>",
        "GERRIT_MCP_PROJECTS": "<YOUR_GERRIT_MCP_PROJECTS>",
        "GERRIT_MCP_OWN_CHANGES_ONLY": "<YOUR_GERRIT_MCP_OWN_CHANGES_ONLY>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_POLL_INTERVAL": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_POLL_INTERVAL>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_INCLUDE_OWN": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_INCLUDE_OWN>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_ACCOUNTS": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_ACCOUNTS>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_PATTERNS": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_PATTERNS>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "go-gerrit-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/gaijinentertainment/go-gerrit-mcp:1.1.3"
      ],
      "env": {
        "GERRIT_URL": "<YOUR_GERRIT_URL>",
        "GERRIT_USERNAME": "<YOUR_GERRIT_USERNAME>",
        "GERRIT_TOKEN": "<YOUR_GERRIT_TOKEN>",
        "GERRIT_MCP_GROUPS": "<YOUR_GERRIT_MCP_GROUPS>",
        "GERRIT_MCP_PROJECTS": "<YOUR_GERRIT_MCP_PROJECTS>",
        "GERRIT_MCP_OWN_CHANGES_ONLY": "<YOUR_GERRIT_MCP_OWN_CHANGES_ONLY>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_POLL_INTERVAL": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_POLL_INTERVAL>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_INCLUDE_OWN": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_INCLUDE_OWN>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_ACCOUNTS": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_ACCOUNTS>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_PATTERNS": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_PATTERNS>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "go-gerrit-mcp": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/gaijinentertainment/go-gerrit-mcp:1.1.3"
      ],
      "env": {
        "GERRIT_URL": "<YOUR_GERRIT_URL>",
        "GERRIT_USERNAME": "<YOUR_GERRIT_USERNAME>",
        "GERRIT_TOKEN": "<YOUR_GERRIT_TOKEN>",
        "GERRIT_MCP_GROUPS": "<YOUR_GERRIT_MCP_GROUPS>",
        "GERRIT_MCP_PROJECTS": "<YOUR_GERRIT_MCP_PROJECTS>",
        "GERRIT_MCP_OWN_CHANGES_ONLY": "<YOUR_GERRIT_MCP_OWN_CHANGES_ONLY>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_POLL_INTERVAL": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_POLL_INTERVAL>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_INCLUDE_OWN": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_INCLUDE_OWN>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_ACCOUNTS": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_ACCOUNTS>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_PATTERNS": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_PATTERNS>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "go-gerrit-mcp": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/gaijinentertainment/go-gerrit-mcp:1.1.3"
      ],
      "env": {
        "GERRIT_URL": "<YOUR_GERRIT_URL>",
        "GERRIT_USERNAME": "<YOUR_GERRIT_USERNAME>",
        "GERRIT_TOKEN": "<YOUR_GERRIT_TOKEN>",
        "GERRIT_MCP_GROUPS": "<YOUR_GERRIT_MCP_GROUPS>",
        "GERRIT_MCP_PROJECTS": "<YOUR_GERRIT_MCP_PROJECTS>",
        "GERRIT_MCP_OWN_CHANGES_ONLY": "<YOUR_GERRIT_MCP_OWN_CHANGES_ONLY>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_POLL_INTERVAL": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_POLL_INTERVAL>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_INCLUDE_OWN": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_INCLUDE_OWN>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_ACCOUNTS": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_ACCOUNTS>",
        "GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_PATTERNS": "<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_PATTERNS>"
      }
    }
  }
}

Claude Code

claude mcp add go-gerrit-mcp --env GERRIT_URL=<YOUR_GERRIT_URL> --env GERRIT_USERNAME=<YOUR_GERRIT_USERNAME> --env GERRIT_TOKEN=<YOUR_GERRIT_TOKEN> --env GERRIT_MCP_GROUPS=<YOUR_GERRIT_MCP_GROUPS> --env GERRIT_MCP_PROJECTS=<YOUR_GERRIT_MCP_PROJECTS> --env GERRIT_MCP_OWN_CHANGES_ONLY=<YOUR_GERRIT_MCP_OWN_CHANGES_ONLY> --env GERRIT_MCP_REVIEW_NOTIFICATIONS=<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS> --env GERRIT_MCP_REVIEW_NOTIFICATIONS_POLL_INTERVAL=<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_POLL_INTERVAL> --env GERRIT_MCP_REVIEW_NOTIFICATIONS_INCLUDE_OWN=<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_INCLUDE_OWN> --env GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_ACCOUNTS=<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_ACCOUNTS> --env GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_PATTERNS=<YOUR_GERRIT_MCP_REVIEW_NOTIFICATIONS_EXCLUDE_PATTERNS> -- docker run -i --rm ghcr.io/gaijinentertainment/go-gerrit-mcp:1.1.3