Back
Directory/GitLab

TL;DR

GitLab is a Version Control MCP server that lets Claude Code, Cursor, Windsurf and any MCP-compatible AI agent gitLab API — projects, merge requests, pipelines. Install in 1 minute with mcpizy install gitlab.

🦊

GitLab

7 tools Supports hosted execution →

Version Control

Last updated August 9, 2026 · By MCPizy team

GitLab API — projects, merge requests, pipelines

Official homepage

Run GitLab without any local install

Connect your GitLab account once — MCPizy stores the credentials encrypted and uses them whenever you run a recipe in managed mode.

Checking connection…

Install GitLab

Via MCPizy CLI (recommended):
mcpizy install gitlab
Or run directly:
npx -y @abergs/mcp-server-gitlab
View on GitHub

Tools exposed

7 tools available
list_projects

List accessible GitLab projects

Inputs

  • searchstringoptional
get_project

Get a project's metadata

Inputs

  • project_idstringrequired
list_issues

List issues in a project

Inputs

  • project_idstringrequired
  • statestringoptional
create_issue

Open a new issue

Inputs

  • project_idstringrequired
  • titlestringrequired
list_merge_requests

List MRs with filters

Inputs

  • project_idstringrequired
create_merge_request

Open a new MR

Inputs

  • project_idstringrequired
  • titlestringrequired
  • source_branchstringrequired
  • target_branchstringrequired
get_file_contents

Read a file from a repo

Inputs

  • project_idstringrequired
  • file_pathstringrequired
  • refstringoptional

Configuration

Works identically across clients. Only the config file path differs.

Claude Code~/.claude.json
{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "glpat-...",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}
Cursor.cursor/mcp.json
{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "glpat-...",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}
Windsurf~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "glpat-...",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

Authentication setup

  1. 1

    Create a PAT with api + read_repository scopes

    Get it GITLAB_PERSONAL_ACCESS_TOKEN

What you can do with GitLab MCP

Paste any of these prompts into Claude Code, Cursor or another MCP-compatible client.

“List open merge requests assigned to me”

Uses: list_merge_requests

“Create an issue in project 1234 titled 'Flaky CI build'”

Uses: create_issue

“Show me the content of .gitlab-ci.yml from my project”

Uses: get_file_contents

Works with

Claude Code
Claude Desktop
Cursor
Windsurf
VS Code + Copilot
Any MCP Client

More Version Control MCPs

🍵

Gitea

Manage Gitea repositories, issues, and pull requests for self-hosted Git from AI agents.

🐙

GitHub

Official GitHub MCP — repos, issues, PRs

Alternatives to GitLab

If GitLab doesn't fit your stack, these Version Control MCP servers solve similar problems.

📦

Git

Local Git repository operations

🔴

Gitee

Gitee API integration for repository, issue, and pull request management. China's GitHub.

🐙

GitKraken

CLI for interacting with GitKraken APIs including Jira, GitHub, GitLab, and Bitbucket.

Key Takeaways

  • GitLab exposes 7 tools for version control workflows in Claude Code, Cursor and Windsurf.
  • Authentication: 1 step (GITLAB_PERSONAL_ACCESS_TOKEN).
  • Install in 1 command: mcpizy install gitlab — config written to your client automatically.
  • Free and open source (GitHub source linked above) — verified compatible with every MCP client (Claude Code, Claude Desktop, Cursor, Windsurf, VS Code + Copilot).
  • Best use case: "List open merge requests assigned to me".

Frequently asked questions

What is the GitLab MCP server?

The GitLab MCP server is an Version Control Model Context Protocol server that lets Claude Code, Cursor, Windsurf, VS Code with Copilot, and other MCP-compatible AI agents gitLab API — projects, merge requests, pipelines. It exposes GitLab's capabilities as tools the AI can call directly from your editor or CLI.

How do I install GitLab MCP with Claude Code?

The fastest way is the MCPizy CLI: run `mcpizy install gitlab` and MCPizy will add the server to your `.claude.json` automatically. You can also install it manually by adding an entry under `mcpServers` in `.claude.json` with the command `npx -y @abergs/mcp-server-gitlab` and restarting Claude Code.

Is GitLab MCP free?

Yes. The GitLab MCP server is free and open source (see the GitHub repository linked on this page). You may still need a GitLab account or API key to connect the server to the underlying service, but the MCP layer itself has no MCPizy subscription cost.

Does GitLab MCP work with Cursor and Windsurf?

Yes. Any MCP-compatible client works — including Claude Code, Claude Desktop, Cursor (via `.cursor/mcp.json`), Windsurf, VS Code with Copilot Chat, and custom agents built on the MCP SDK. The same install command targets all of them; only the config file path differs.

What can I do with GitLab MCP?

Once installed, your AI agent can gitLab API — projects, merge requests, pipelines directly inside your conversation. Typical use cases include asking Claude Code or Cursor to run GitLab operations, inspect results, chain GitLab with other MCP servers (see our Workflow Recipes), and automate repetitive version control tasks without leaving your editor.

Manage all your MCPs in one place

Monitor usage, track costs, and discover new MCPs.

Get Started Free