home / mcp / gitlab mcp server

GitLab MCP Server

Provides a GitLab MCP Server to interact with GitLab projects, merge requests, CI/CD, and project settings via MCP clients.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can interact with GitLab from an MCP client through a dedicated GitLab MCP Server. It lets you inspect projects, manage merge requests, view diffs, configure CI/CD, and handle project settings, all via structured MCP commands that integrate with your AI assistant workflows.

How to use

Treat this server as a bridge between your AI assistant and GitLab. With an MCP client, you can list projects, inspect merge requests, fetch file contents, add comments or internal notes, trigger pipelines, manage CI/CD variables, and configure webhooks. Start by starting the local MCP server (see the install steps) and then connect your MCP client to the local endpoint. Use explicit project paths and merge request IDs when asking the assistant to perform actions.

How to install

1. Prerequisites
2. Node.js 16 or higher
3. npm (comes with Node.js)

Step-by-step installation and setup commands you can run now:

git clone https://github.com/rifqi96/mcp-gitlab.git
cd mcp-gitlab
```
```
npm install
```
```
npm run build
```
```
npm run install-hooks

Configure your GitLab API token

Provide your GitLab API token and the API URL in your MCP client settings so the server can authenticate to GitLab.

Two example configuration blocks for common MCP clients are shown here. Replace YOUR_GITLAB_API_TOKEN with your actual GitLab API token.

{
  "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"
      }
    }
  }
}

{
  "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"
      }
    }
  }
}