MCP.so
Sign In

mcp-gitlab-server

@kopiloto

Repository

About mcp-gitlab-server

No overview available yet

#mcp-gitlab#gitlab-server#python-gitlab

Basic information

Category

Version Control

License

MIT

Runtime

python

Transports

stdio

Publisher

kopiloto

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "GitLab": {
      "command": "uvx",
      "args": [
        "gitlab-mcp-server"
      ],
      "env": {
        "GITLAB_TOKEN": "<your GitLab personal access token>",
        "GITLAB_URL": "https://gitlab.com"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-gitlab-server?

mcp-gitlab-server is a GitLab integration server for the Model Context Protocol (MCP). Built on python-gitlab, it provides tools for repository and project management, code reading, and merge request analytics. It is intended for developers and teams using GitLab who want to interact with their projects through MCP clients like Claude Desktop.

How to use mcp-gitlab-server?

Install by adding a configuration entry to your MCP client using the command uvx with the package gitlab-mcp-server. Set the environment variables GITLAB_TOKEN (or GITLAB_OAUTH_TOKEN) and optionally GITLAB_URL (defaults to https://gitlab.com). You can authenticate with a personal access token or an OAuth2 token.

Key features of mcp-gitlab-server

  • List, search, and get details for GitLab projects and groups
  • Read repository code and files with glob filtering and size limits
  • Analyze merge request lifetime statistics (average, percentiles, distribution)
  • Support for GitLab.com and self-hosted GitLab instances
  • Authentication via personal access token or OAuth2 token

Use cases of mcp-gitlab-server

  • Automatically index all projects accessible to a user
  • Read code contents from a repository without cloning it locally
  • Calculate and report merge request turnaround times for a team
  • Search across repositories by name, description, or keywords

FAQ from mcp-gitlab-server

What authentication methods are supported?

Two methods: Personal Access Token (set GITLAB_TOKEN) or OAuth2 Token (set GITLAB_OAUTH_TOKEN). The server checks for GITLAB_OAUTH_TOKEN first, then falls back to GITLAB_TOKEN. You only need to set one.

Can I use a self‑hosted GitLab instance?

Yes. Set the GITLAB_URL environment variable to your GitLab instance URL (e.g., https://gitlab.example.com). If not set, it defaults to https://gitlab.com.

What environment variables are required?

You must set either GITLAB_TOKEN or GITLAB_OAUTH_TOKEN. Optionally set GITLAB_URL for a non‑default instance. The server will use the OAuth2 token if present; otherwise it uses the personal access token.

What tools does mcp-gitlab-server provide?

It offers tools for project/group listing, repository code reading, file reading, search, merge request listing, and merge request analytics (lifetime statistics with percentiles). See the README for the complete list and example usage.

Is mcp-gitlab-server ready for production?

No. This project is in development stage. Features and APIs may change without notice. Use with caution in production environments.

Comments

More Version Control MCP servers

MCP Atlassian Server (by phuc-nt)

phuc-nt

MCP server connecting AI assistants with Jira & Confluence for smart project management.

52

AIO-MCP Server

athapong

🚀 All-in-one MCP server with AI search, RAG, and multi-service integrations (GitLab/Jira/Confluence/YouTube) for AI-enhanced development workflows. Folk from https://github.com/nguyenvanduocit/all-in-one-model-context-protocol

36

Jira MCP

nguyenvanduocit

A Go-based MCP (Model Control Protocol) connector for Jira that enables AI assistants like Claude to interact with Atlassian Jira. This tool provides a seamless interface for AI models to perform common Jira operations including issue management, sprint planning, and workflow tra

92

Atlassian Data Center MCP

b1ff

MCP servers for the Atlassian products (Bitbucket, Confluence, JIRA) of the Data Center version

81

GitHub Actions 工作流使用说明

HenryHaoson

Yuque mcp server

66