mcp-gitlab-server

Overview

GitLab MCP Server provides a comprehensive interface between AI agents and GitLab instances, exposing 86 tools covering repositories, files, branches, issues, merge requests, CI/CD pipelines, wikis, groups, and more. It supports stdio, SSE, and Streamable HTTP transports with both PAT and OAuth authentication modes. The server is actively maintained with enterprise-ready features including read-only mode, Docker image, Kubernetes Helm chart, and comprehensive security measures.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• search_repositories

  Search for GitLab repositories using various criteria

  Try:Find repositories with 'mcp' in the nameTry:Search for repositories owned by 'yoda-digital'
• create_repository

  Create a new GitLab repository

  Try:Create a new repository named 'my-project' with description 'Test project'
• read_file

  Read a file from a GitLab repository

  Try:Show me the content of README.md in the main branch
• update_file

  Update a file in a GitLab repository

  Try:Update index.js with new contentTry:Fix the typo in the documentation file
• create_issue

  Create a new issue in a GitLab project

  Try:Create a bug report for login issuesTry:Add a feature request for dark mode
• create_merge_request

  Create a new merge request in a GitLab project

  Try:Create an MR to merge feature-branch into mainTry:Open a merge request for the hotfix
• list_pipelines

  List CI/CD pipelines for a project

  Try:Show me the last 5 pipelines for this projectTry:List all failed pipelines
• trigger_pipeline

  Trigger a new CI/CD pipeline

  Try:Run pipeline for main branchTry:Trigger pipeline with specific variables
• create_tag

  Create a new tag in a GitLab repository

  Try:Create a version tag 'v1.2.3'Try:Tag the current commit as 'release-2.0'
• create_release

  Create a new release in GitLab

  Try:Create a release for version 1.0.0Try:Publish a new release with changelog
• list_members

  List members of a GitLab project or group

  Try:Show all members of this projectTry:List group members with access level
• create_group

  Create a new GitLab group

  Try:Create a new group named 'my-team'Try:Set up a subgroup for project management

Comparable tools

Installation

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@yoda.digital/gitlab-mcp-server"],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "glpat-…",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

docker run --rm -p 3000:3000 \
  -e HOST=0.0.0.0 \
  -e AUTH_MODE=oauth \
  -e USE_STREAMABLE_HTTP=true \
  ghcr.io/yoda-digital/mcp-gitlab-server:latest

helm install gitlab-mcp oci://ghcr.io/yoda-digital/charts/gitlab-mcp

FAQ

Does this work with self-hosted GitLab instances?

Yes, set the GITLAB_API_URL environment variable to your instance's API endpoint, e.g., 'https://gitlab.example.com/api/v4'

Can I use this in read-only mode?

Yes, set GITLAB_READ_ONLY_MODE=true to hide all write tools and prevent mutations

What authentication methods are supported?

Personal Access Token (PAT) for local use and OAuth Bearer tokens for remote deployments

Compare mcp-gitlab-server with