qodev-gitlab-mcp

A Model Context Protocol (MCP) server for GitLab integration. Exposes projects, merge requests, pipelines, discussions, issues, releases, and more through a standardized interface for AI assistants like Claude.

Installation

pip install qodev-gitlab-mcp

Or run directly with uvx:

uvx qodev-gitlab-mcp

Configuration

Set the following environment variables:

# Required
GITLAB_TOKEN=glpat-YOUR-TOKEN-HERE

# Optional (defaults to https://gitlab.com)
GITLAB_URL=https://gitlab.com

Claude Code

Add to your MCP configuration:

{
  "mcpServers": {
    "gitlab": {
      "command": "uvx",
      "args": ["qodev-gitlab-mcp"],
      "env": {
        "GITLAB_TOKEN": "your-token-here",
        "GITLAB_URL": "https://gitlab.com"
      }
    }
  }
}

Quick Start

Once configured, the MCP server gives your AI assistant access to GitLab. Example interactions:

• "Is my MR ready to merge?" -- checks pipeline, approvals, and unresolved discussions
• "Create a merge request for this branch" -- creates MR with auto-detected source branch
• "Wait for the pipeline to finish" -- monitors pipeline and reports results with failed job logs
• "Comment on MR !42 saying LGTM" -- posts a comment on the merge request

Features

• Merge request management (create, comment, merge, close, inline comments)
• Pipeline monitoring with wait_for_pipeline tool
• Issue tracking (create, update, close, comment)
• Release management
• CI/CD variable management
• File uploads with image support
• Automatic "current" project/branch detection via MCP workspace roots

Tools

The server exposes the following MCP tools:

Merge Requests

Pipelines

Issues

Releases

CI/CD Variables

Files

All tools support project_id="current" to auto-detect the project from the current working directory. Merge request tools also support mr_iid="current" to detect the MR for the current branch.

Resources

The server exposes the following read-only MCP resources:

Projects

Merge Requests

Pipelines & Jobs

Issues

Releases

CI/CD Variables

Help

License

MIT