home / mcp / gitlab mcp server

GitLab MCP Server

Provides a full GitLab MCP server with 86 tools for managing GitLab resources via MCP.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "yoda-digital-mcp-gitlab-server": {
      "command": "npx",
      "args": [
        "-y",
        "@yoda.digital/gitlab-mcp-server"
      ],
      "env": {
        "GITLAB_URL": "https://gitlab.com",
        "GITLAB_READ_ONLY": "false",
        "GITLAB_PERSONAL_ACCESS_TOKEN": "YOUR_GITLAB_TOKEN"
      }
    }
  }
}

You can run a GitLab MCP Server locally or in your environment to manage GitLab resources via the MCP protocol. This server exposes a comprehensive set of GitLab capabilities through MCP, enabling AI assistants and automation tools to perform repository, issue, merge request, pipeline, wiki, and group operations among others in a structured, scalable way.

How to use

To connect an MCP client, select the GitLab MCP Server as your target. This server is designed to be consumed via standard MCP requests over a local process or a hosted runtime. You can run it with an MCP client that supports the MCP protocol and point it at the server invocation described in the installation guide. For best results, provide your GitLab Personal Access Token (PAT) and the GitLab instance URL so the server can authenticate and access resources on your behalf.

How to install

Prerequisites: You need Node.js and npm installed on your machine. You can verify installations with these commands.

node -v
npm -v

Option A: Install from npm (recommended) and run directly with MCP client support.

npm install @yoda.digital/gitlab-mcp-server

Option B: Install from source and build before running.

git clone https://github.com/yoda-digital/mcp-gitlab-server.git
cd mcp-gitlab-server
npm install
npm run build

Start or initialize the MCP server using the recommended approach with MCP client integration. The client configuration typically uses npx to run the server without a global install.

npx -y @yoda.digital/gitlab-mcp-server

Configuration and usage notes

Configure your MCP client to point at the GitLab MCP Server using the runtime command and environment variables described below. You will typically provide a GitLab PAT and the GitLab instance URL for authentication and API access.