GitLab MCP Server

● Active

io.github.sumirati/mcp-gitlab

Developer-ready GitLab MCP server for CE and EE instances.

Connect this server

One click to install, or copy the config below. Suits: Claude Desktop · Cursor.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "mcp-gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@sumirati/mcp-gitlab@3.2.0"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<your GITLAB_PERSONAL_ACCESS_TOKEN>",
        "GITLAB_API_URL": "https://gitlab.com/api/v4",
        "GITLAB_READ_ONLY": "false",
        "GITLAB_EXPOSE_ALL_TOOLS": "false",
        "MCP_OUTPUT_FORMAT": "markdown"
      }
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --env GITLAB_PERSONAL_ACCESS_TOKEN='<your GITLAB_PERSONAL_ACCESS_TOKEN>' --env GITLAB_API_URL=https://gitlab.com/api/v4 --env GITLAB_READ_ONLY=false --env GITLAB_EXPOSE_ALL_TOOLS=false --env MCP_OUTPUT_FORMAT=markdown --transport stdio mcp-gitlab -- npx -y @sumirati/mcp-gitlab@3.2.0
OpenAI Codex CLI
codex mcp add mcp-gitlab --env GITLAB_PERSONAL_ACCESS_TOKEN='<your GITLAB_PERSONAL_ACCESS_TOKEN>' --env GITLAB_API_URL=https://gitlab.com/api/v4 --env GITLAB_READ_ONLY=false --env GITLAB_EXPOSE_ALL_TOOLS=false --env MCP_OUTPUT_FORMAT=markdown -- npx -y @sumirati/mcp-gitlab@3.2.0
VS Code
code --add-mcp '{"name":"mcp-gitlab","type":"stdio","command":"npx","args":["-y","@sumirati/mcp-gitlab@3.2.0"],"env":{"GITLAB_PERSONAL_ACCESS_TOKEN":"<your GITLAB_PERSONAL_ACCESS_TOKEN>","GITLAB_API_URL":"https://gitlab.com/api/v4","GITLAB_READ_ONLY":"false","GITLAB_EXPOSE_ALL_TOOLS":"false","MCP_OUTPUT_FORMAT":"markdown"}}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in.

Environment variables
  • GITLAB_PERSONAL_ACCESS_TOKENrequiredsecretGitLab Personal Access Token with api scope
  • GITLAB_API_URLGitLab instance API URL (defaults to https://gitlab.com/api/v4)
  • GITLAB_READ_ONLYEnable read-only safety mode (true/false, default: false)
  • GITLAB_EXPOSE_ALL_TOOLSSet to true to expose all 90 catalog actions directly on ListTools instead of the 5-tool hybrid surface
  • MCP_OUTPUT_FORMATDefault output format: 'markdown' (default, compact tables) or 'json'

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Developer Tools
Version
3.2.0
Registry
active
Published
10/16/2026

On GitHub

read Nov 17, 2026
Stars
1
Forks
0
Last push
Oct 16, 2026
License
MIT

JavaScript

From the README

GitLab MCP Server (@sumirati/mcp-gitlab) A modern, 2026 AI-native Model Context Protocol (MCP) server for GitLab API v4, engineered for self-hosted GitLab Community Edition (CE), Enterprise Edition (EE), and GitLab.com. What makes v3.0.0 Unique: The 2026 5-Tool Hybrid Standard In early MCP servers, dumping 50–100 tools into the client's tool list consumed 10,000+ prompt context tokens on every turn ("System Prompt Tax") and resulted in poor Coherence ratings on the Glama TDQS rubric. @sumirati/mcp-gitlab v3 solves this with a 5-Tool Hybrid Surface: • Glama TDQS Coherence Tier A (5/5): By exposing exactly 5 tools to the client, the server sits in the ideal 3–15 tool coherence sweet spot. • Ultra-Lean System Prompt Tax: Drops schema overhead from 27,681 tokens to 1,292 tokens (95.3% reduction), preserving context windows and maximizing LLM prompt-cache hits. • Zero-Hop Hourly Drivers: The 3 operations developers and agents actually use constantly during pair-programming (getfilecontents, getproject, getcommit) remain eager tools for instant zero-hop execution. • 100% Platform Access on Demand: The entire platform surface of 90 actions across 14 domains is accessible on-demand via dynamic action discovery (gitlabfindactions $\rightarrow$ gitlabexecuteaction), delivering 75%–96% token savings with default high-density Markdown tables and summaries (format: "markdown" | "json"). • Resilient Fallback: If an agent directly invokes any catalog action name (e.g.…

Read the full README on GitHub →

Alternatives to GitLab MCP Server

Best Developer Tools servers →

The most-starred Developer Tools servers in the index, with their live-check result.

ServerStarsLast pushLive check
REA466,935Nov 2026Local / not checked
GitHub34,466Nov 2026Needs sign-in
Repomix29,280Nov 2026Local / not checked
Compiler Explorer19,188Nov 2026Working
XERJ19,135Nov 2026Local / not checked

GitLab MCP Server: questions people ask

Is GitLab MCP Server a remote or a local MCP server?
According to its entry in the official MCP registry, GitLab MCP Server ships as a local package (npm) that your client starts on your machine.
Does GitLab MCP Server need an API key?
Its registry entry declares one required environment variable: GITLAB_PERSONAL_ACCESS_TOKEN. The config on this page shows where each goes.
Is GitLab MCP Server still maintained?
Active: the repository's last commit 1 month ago. Last push Oct 16, 2026, 1 GitHub stars, MIT licence. Read from GitHub on Nov 17, 2026.
How do I add GitLab MCP Server to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
Browse all Developer Tools →

Add the badge to your site

Show visitors that GitLab MCP Server is listed here — it’s also the link we check for a free listing.

GitLab MCP Server — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/io-github-sumirati-mcp-gitlab?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="GitLab MCP Server — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![GitLab MCP Server — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/io-github-sumirati-mcp-gitlab?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.