GitLab MCP Server

A Model Context Protocol (MCP) server that enables you to interact with your GitLab account. Get diffs, analyze merge requests, review code, cherry-pick changes, and more. This is an extended version of the MCP GitLab Server from the Model Context Protocol project.

Features

This MCP server provides comprehensive tools for interacting with GitLab repositories, including:

Core Repository Features

Listing projects and retrieving details
Managing branches and repositories
Working with merge requests and diffs
Adding comments and internal notes to merge requests
Updating merge request attributes
Listing and working with issues
Getting and comparing repository file contents

Project Settings & Integrations

Managing project integrations and services
Configuring and controlling Slack integration
Setting up, updating, and testing webhooks

CI/CD Management

Working with pipeline trigger tokens
Managing CI/CD variables
Triggering and controlling pipelines

User & Group Administration

Listing and managing users
Working with groups and group memberships
Managing project members and access levels

Installation

Prerequisites

Node.js (v16 or higher)
npm
A GitLab account with an API token

Setup

Clone the repository:

git clone https://github.com/rifqi96/mcp-gitlab.git
cd mcp-gitlab

Install dependencies:

npm install

Build the server:

npm run build

Install git hooks (optional, but recommended for contributors):

npm run install-hooks

This installs a pre-commit hook that automatically regenerates TOOLS.md when src/utils/tools-data.ts changes.

Configure your GitLab API token:

You need to provide your GitLab API token in the MCP settings configuration file. The token is used to authenticate with the GitLab API.

For Cursor/Roo Cline, add the following to your MCP settings file (~/Library/Application Support/Cursor/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json):

{
  "mcpServers": {
    "gitlab": {
      "command": "node",
      "args": [
        "/path/to/mcp-gitlab/build/index.js"
      ],
      "env": {
        "GITLAB_API_TOKEN": "YOUR_GITLAB_API_TOKEN",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

For Claude Desktop, add the following to your MCP settings file (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "gitlab": {
      "command": "node",
      "args": [
        "/path/to/mcp-gitlab/build/index.js"
      ],
      "env": {
        "GITLAB_API_TOKEN": "YOUR_GITLAB_API_TOKEN",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

Replace YOUR_GITLAB_API_TOKEN with your actual GitLab API token. You can generate a token in your GitLab account under Settings > Access Tokens.

Available Tools

For a complete list of available tools and their parameters, see TOOLS.md.

Example Usage

Here are examples of how to use these tools with AI assistants that support MCP:

List your projects

Could you list my GitLab projects?

Get information about a specific merge request

Can you show me the details of merge request with ID 123 in the project 'mygroup/myproject'?

Add a comment to a merge request

Please add a comment to merge request 123 in project 'mygroup/myproject' saying "This looks good, but please add more tests."

Add an internal note to a merge request

Add an internal note to merge request 123 in project 'mygroup/myproject' that says "Needs security review before merging." Make sure it's only visible to team members.

Update a merge request title and description

Update the title of merge request 123 in project 'mygroup/myproject' to "Fix login page performance issues" and update the description to include "This PR addresses the slow loading times on the login page by optimizing database queries."

Compare branches

Compare the 'feature-branch' with 'main' in the project 'mygroup/myproject' and show me the differences.

Practical Workflows

Reviewing a Merge Request

1. Show me merge request 123 in project 'mygroup/myproject'
2. Show me the changes for this merge request
3. Add an internal note with my review comments
4. Update the merge request title to better reflect the changes

Project Exploration

1. List all my GitLab projects
2. Show me the details of project 'mygroup/myproject'
3. List all branches in this project
4. Show me the content of the README.md file in the main branch

Available Resources

gitlab://projects

List of GitLab projects accessible with your API token.

Integration with AI Assistants

The GitLab MCP Server integrates with AI assistants that support the Model Context Protocol (MCP).

Capabilities

When connected to an AI assistant, this server enables the assistant to:

View and analyze code: The assistant can fetch file contents, view branch differences, and examine merge request changes for better code understanding.
Provide code reviews: The assistant can analyze merge requests and provide feedback through comments or internal notes.
Manage project workflows: The assistant can update merge request attributes, add comments, and help with repository management tasks.
Explore project structure: The assistant can browse projects, branches, and files to understand the codebase structure.
Configure CI/CD and integrations: The assistant can help set up webhooks, manage CI/CD variables, and configure project integrations.

Getting the Most from AI Assistant Integration

Be specific when asking about projects, merge requests, or files
Provide project IDs or paths when possible
Use the assistant for code review by asking it to analyze specific merge requests
Have the assistant help with repository configuration and management tasks
Use internal notes for team-only feedback on merge requests

License

MIT

GitLab MCP Server