GitLab MR MCP

Connect your AI assistant to GitLab. Ask questions like “List open merge requests”, “Show me reviews for MR #123”, “Get commit discussions for MR #456”, or “Find merge requests for the feature branch” directly in your chat.

Table of Contents

• Quick Setup
• What You Can Do
• Configuration Options
• Troubleshooting
• Tool Reference
• Roadmap
• Development
• Security Notes
• Support

Quick Setup

Installation

# Using pipx (recommended)
pipx install gitlab-mr-mcp

# Or using uv
uv tool install gitlab-mr-mcp

# Or using pip
pip install gitlab-mr-mcp

Note: Using pipx or uv tool is recommended as they automatically add the gitlab-mcp command to your PATH. If using pip install, ensure your Python scripts directory is in PATH, or use the full path to the command.

Get your GitLab token

1. Go to GitLab → Settings → Access Tokens
2. Create token with read_api scope (add api scope if you want write access)
3. Copy the token

Configure your MCP client

Multi-Project Setup (Recommended)

For working with multiple GitLab projects, add to your global MCP config (~/.cursor/mcp.json for Cursor):

{
  "mcpServers": {
    "gitlab-mcp": {
      "command": "gitlab-mcp",
      "env": {
        "GITLAB_URL": "https://gitlab.com",
        "GITLAB_ACCESS_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

This single configuration works across all your projects. Use search_projects or list_my_projects to find project IDs, then specify project_id in your requests.

Single-Project Setup

For working with a single project, you can set a default project ID:

{
  "mcpServers": {
    "gitlab-mcp": {
      "command": "gitlab-mcp",
      "env": {
        "GITLAB_URL": "https://gitlab.com",
        "GITLAB_ACCESS_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx",
        "GITLAB_PROJECT_ID": "12345"
      }
    }
  }
}

Restart your MCP client and start asking GitLab questions!

What You Can Do

Once connected, try these commands in your chat:

Multi-Project Workflow

• “What projects do I have access to?”
• “Search for the backend project”
• “Show open MRs for project 12345”