A Model Context Protocol (MCP) server that enables AI agents to interact with GitLab Merge Requests. This server exposes GitLab MR operations as MCP tools, allowing seamless integration with Claude Code, Claude Desktop, and other MCP-compatible clients.

日本語版ドキュメント

• MR Lifecycle Management: Create, update, merge, and close merge requests
• Code Review Support: Add comments, create discussions, approve/unapprove MRs
• CI/CD Integration: View pipeline status and job details
• Change Analysis: Get detailed file diffs and changes
• Flexible Access Control: Enable/disable tools via environment variables
• Secure: Personal Access Token authentication with token masking in logs

Get up and running in under 5 minutes:

# Option A: go install (recommended)
go install github.com/kqns91/gitlab-mcp/cmd/gitlab-mcp@latest

# Option B: Build from source
git clone https://github.com/kqns91/gitlab-mcp.git
cd gitlab-mcp
go build -o gitlab-mcp ./cmd/gitlab-mcp

Create a Personal Access Token with api scope:

1. Go to GitLab → Settings → Access Tokens
2. Create a token with api scope
3. Copy the token

Add to your Claude Code or Claude Desktop config (see Usage with MCP Clients for details):

{
  "mcpServers": {
    "gitlab": {
      "command": "gitlab-mcp",
      "env": {
        "GITLAB_URL": "https://gitlab.com",
        "GITLAB_TOKEN": "your-token"
      }
    }
  }
}

# Enable only read operations
export GITLAB_MCP_ENABLED_TOOLS="list_merge_requests,get_merge_request,get_merge_request_changes"

# Disable destructive operations
export GITLAB_MCP_DISABLED_TOOLS="merge_merge_request,approve_merge_request"

# DISABLED_TOOLS takes precedence over ENABLED_TOOLS

Add to your Claude Code configuration:

{
  "mcpServers": {
    "gitlab": {
      "command": "/path/to/gitlab-mcp",
      "env": {
        "GITLAB_URL": "https://gitlab.com",
        "GITLAB_TOKEN": "your-token"
      }
    }
  }
}

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "gitlab": {
      "command": "/path/to/gitlab-mcp",
      "env": {
        "GITLAB_URL": "https://gitlab.com",
        "GITLAB_TOKEN": "your-token"
      }
    }
  }
}

Config file locations:

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

Once configured, you can ask Claude to:

• "List all open merge requests in project mygroup/myproject"
• "Get the details of MR #42 in myproject"
• "Create a merge request from feature-branch to main with title 'Add new feature'"
• "Add a comment to MR #42 saying 'LGTM!'"
• "Approve MR #42"
• "What's the pipeline status for MR #42?"

• Go 1.23 or later
• Git

go build -o gitlab-mcp ./cmd/gitlab-mcp

go test ./...

.
├── cmd/gitlab-mcp/        # Application entry point
├── internal/
│   ├── config/            # Configuration management
│   ├── gitlab/            # GitLab API client wrapper
│   ├── registry/          # MCP tool registry
│   └── tools/             # MCP tool implementations
│       ├── approval/      # Approval tools
│       ├── discussion/    # Discussion tools
│       ├── mergerequest/  # Merge request tools
│       └── pipeline/      # Pipeline tools
└── test/integration/      # Integration tests

This project is licensed under the MIT License - see the LICENSE file for details.

• Model Context Protocol - The protocol specification
• MCP Go SDK - Official Go SDK
• GitLab Go SDK - Official GitLab API client