GitLab MCP Server
● Activeio.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.
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"
}
}
}
}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.0codex 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.0code --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.
- 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.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| REA | 466,935 | Nov 2026 | Local / not checked |
| GitHub | 34,466 | Nov 2026 | Needs sign-in |
| Repomix | 29,280 | Nov 2026 | Local / not checked |
| Compiler Explorer | 19,188 | Nov 2026 | Working |
| XERJ | 19,135 | Nov 2026 | Local / 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.
More Developer Tools servers
Browse all Developer Tools →Tteop MCP
SunrisesIllNeverSee
Build, validate, and describe TTEOP telemetry envelopes for AI operator token efficiency.
falsepass
Super-Eric
Find RL environment graders that pay wrong answers: probes reward code, returns reproducible leads
WTFM
SupportPages-io
Your coding agent writes the user docs from your codebase, screenshots included.
SuprSend
suprsend
Manage SuprSend entities — workflows, templates, users, objects, tenants — from your AI assistant.
Myopic
SurajKGoyal
Code-review MCP: review a GitLab MR or GitHub PR against the whole codebase, not just the diff.
Devicely
sureshkumarm8
Control real iOS & Android devices from AI agents; mirror one tap across a whole fleet.
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.
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
[](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.