SERVER

gitlab-mcp

Rank #12

io.github.zereight/gitlab-mcp

GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more.

69 versions
2,044 GitHub stars
by zereight (4 servers)View repository ↗
First listed
Feb 10, 2025
Last publish date
Oct 15, 2026
PURPOSE

What you can do with gitlab-mcp

A community MCP server for GitLab that lets an agent manage projects, merge requests, issues, pipelines, wiki pages, releases, tags and milestones on GitLab.com or a self-hosted instance.

Suitable tasks
  • Review, approve and merge merge requests
  • Create and update issues and work items
  • Inspect pipelines, jobs and CI variables
  • Read and write repository files and branches
  • Edit wiki pages, releases and milestones
  • Run arbitrary GraphQL queries against GitLab
CAPABILITIES AND LIMITATIONS

What gitlab-mcp can and cannot do

Capabilities

About 267 tools covering merge requests, issues and work items, repositories, projects and groups, CI/CD, wiki, milestones, releases, users, webhooks, code search, snippets and vulnerabilities, plus a discover_tools tool that activates more categories at runtime. Tool filtering uses GITLAB_TOOLSETS, GITLAB_TOOLS and GITLAB_DENIED_TOOLS_REGEX.

Documented tools (2 of 267)
  • discover_tools
  • execute_graphql
Limitations
  • SSE transport is incompatible with REMOTE_AUTHORIZATION and the MCP OAuth proxy; those modes need Streamable HTTP
  • Some tools depend on GitLab tier or features: release evidence and work item statuses need Premium/Ultimate, code search needs advanced search or Zoekt
  • Auth sessions expire after SESSION_TIMEOUT_SECONDS of inactivity (default one hour)
  • Default capacity limits apply: 1000 sessions, 60 requests per minute
  • Changing a wiki title changes its URL; use front matter to change only the display title
REQUIREMENTS

What you need before using gitlab-mcp

DeclaredNo credentialsNo credentials declared

The registry listing declares no required environment variables or authentication. This is declared metadata, not a verified install — the repository README is the authority.

Declared by the Official MCP Registry, last synced Oct 16, 2026. Not independently verified by MCP Toplist.

Runtime
Node.js 18.17+ (npx, npm, Homebrew, Nix) or the zereight050/gitlab-mcp Docker image
Credentials
GitLab personal access token, local OAuth2 browser or device flow, MCP OAuth proxy, or per-caller tokens with REMOTE_AUTHORIZATION
Permissions
GITLAB_PERMISSION_MODE: readonly, modify (no delete tools) or full (default)
Also needed
Set GITLAB_API_URL for self-hosted instances; MCP OAuth needs a public HTTPS MCP_SERVER_URL and a registered GitLab OAuth app
Declared in the registry install config
  • GITLAB_PERSONAL_ACCESS_TOKEN · optional
  • GITLAB_PERSONAL_ACCESS_TOKEN_FILE · optional
  • GITLAB_JOB_TOKEN · optional
  • GITLAB_AUTH_COOKIE_PATH · optional
  • GITLAB_USE_OAUTH · optional
  • GITLAB_OAUTH_CLIENT_ID · optional
  • GITLAB_OAUTH_TOKEN_SCRIPT · optional
  • GITLAB_API_URL · optional
  • GITLAB_ALLOWED_PROJECT_IDS · optional
  • GITLAB_PERMISSION_MODE · optional
  • GITLAB_TOOLSETS · optional
  • GITLAB_TOOLS · optional
  • GITLAB_DENIED_TOOLS_REGEX · optional
  • GITLAB_TOOL_POLICY_APPROVE · optional
  • GITLAB_TOOL_POLICY_HIDDEN · optional
  • NODE_TLS_REJECT_UNAUTHORIZED · optional
  • GITLAB_CA_CERT_PATH · optional
  • GITLAB_MASKING_ENABLED · optional
  • GITLAB_MASKING_CONFIG · optional
  • GITLAB_MASKING_POLICY_FILE · optional
  • GITLAB_MASKING_WORKSPACE_DIR · optional
INSTALLATION AND FIRST TASK

Connect gitlab-mcp and confirm it works

  1. Create a GitLab personal access token
  2. Add the server with command npx -y @zereight/mcp-gitlab@latest and GITLAB_PERSONAL_ACCESS_TOKEN in the environment
  3. Set GITLAB_API_URL if you use a self-hosted instance
  4. Set GITLAB_PERMISSION_MODE=readonly to start safely, and GITLAB_TOOLSETS to enable wiki, milestones or pipelines
npm package
claude mcp add gitlab-mcp -e "GITLAB_PERSONAL_ACCESS_TOKEN=<your GITLAB_PERSONAL_ACCESS_TOKEN>" -e "GITLAB_PERSONAL_ACCESS_TOKEN_FILE=<your GITLAB_PERSONAL_ACCESS_TOKEN_FILE>" -e "GITLAB_JOB_TOKEN=<your GITLAB_JOB_TOKEN>" -e "GITLAB_AUTH_COOKIE_PATH=<your GITLAB_AUTH_COOKIE_PATH>" -e "GITLAB_USE_OAUTH=<your GITLAB_USE_OAUTH>" -e "GITLAB_OAUTH_CLIENT_ID=<your GITLAB_OAUTH_CLIENT_ID>" -e "GITLAB_OAUTH_TOKEN_SCRIPT=<your GITLAB_OAUTH_TOKEN_SCRIPT>" -e "GITLAB_API_URL=<your GITLAB_API_URL>" -e "GITLAB_ALLOWED_PROJECT_IDS=<your GITLAB_ALLOWED_PROJECT_IDS>" -e "GITLAB_PERMISSION_MODE=<your GITLAB_PERMISSION_MODE>" -e "GITLAB_TOOLSETS=<your GITLAB_TOOLSETS>" -e "GITLAB_TOOLS=<your GITLAB_TOOLS>" -e "GITLAB_DENIED_TOOLS_REGEX=<your GITLAB_DENIED_TOOLS_REGEX>" -e "GITLAB_TOOL_POLICY_APPROVE=<your GITLAB_TOOL_POLICY_APPROVE>" -e "GITLAB_TOOL_POLICY_HIDDEN=<your GITLAB_TOOL_POLICY_HIDDEN>" -e "NODE_TLS_REJECT_UNAUTHORIZED=<your NODE_TLS_REJECT_UNAUTHORIZED>" -e "GITLAB_CA_CERT_PATH=<your GITLAB_CA_CERT_PATH>" -e "GITLAB_MASKING_ENABLED=<your GITLAB_MASKING_ENABLED>" -e "GITLAB_MASKING_CONFIG=<your GITLAB_MASKING_CONFIG>" -e "GITLAB_MASKING_POLICY_FILE=<your GITLAB_MASKING_POLICY_FILE>" -e "GITLAB_MASKING_WORKSPACE_DIR=<your GITLAB_MASKING_WORKSPACE_DIR>" -- npx -y @zereight/mcp-gitlab

Replace each placeholder with your own value before saving.

First successful task

Ask the agent to list the open merge requests in one of your projects.

Expected: A list of merge requests with titles, authors and states from your GitLab instance.

ALTERNATIVES

When to choose another server

  • GitHub MCP Server#176

    Your repositories are on GitHub rather than GitLab.

  • Repomix#39

    You only need repository contents packed as context, not forge operations.

Compared side by side in GitHub MCP servers.

Other servers by zereight
View all zereight servers →
MAINTENANCE AND EVIDENCE

What changed, and when this was checked

First listed
Feb 10, 2025
Latest version published
Oct 15, 2026
Version history
69 versions tracked (below)
Requirements evidence
Declared by the Official MCP Registry, last synced Oct 16, 2026. Not independently verified by MCP Toplist.
Profile checked
Oct 8, 2026 against README
Ranking data as of
Oct 16, 2026
Registry sightings

Do you maintain gitlab-mcp? to correct or enrich this profile.

VERSIONS

Available versions (69)

2.1.3 · Apr 24, 20262.1.4 · Apr 26, 20262.1.5 · May 3, 20262.1.6 · May 4, 20262.1.7 · May 5, 20262.1.8 · May 5, 20262.1.9 · May 7, 20262.1.10 · May 9, 20262.1.11 · May 13, 20262.1.12 · May 17, 20262.1.13 · May 20, 20262.1.14 · May 21, 20262.1.15 · May 24, 20262.1.16 · May 25, 20262.1.17 · May 30, 20262.1.18 · May 30, 20262.1.19 · Jun 11, 20262.1.20 · Jun 12, 20262.1.21 · Jun 14, 20262.1.22 · Jun 15, 20262.1.23 · Jun 17, 20262.1.24 · Jun 18, 20262.1.25 · Jun 20, 20262.1.26 · Jun 21, 20262.1.27 · Jun 22, 20262.1.28 · Jun 29, 20262.1.29 · Jul 3, 20262.1.30 · Jul 5, 20262.1.38 · Jul 14, 20262.1.39 · Jul 16, 20262.1.40 · Jul 16, 20262.1.41 · Jul 19, 20262.1.42 · Jul 19, 20262.1.43 · Jul 26, 20262.1.44 · Jul 29, 20262.1.46 · Aug 2, 20262.1.47 · Aug 16, 20262.1.48 · Aug 17, 20262.1.49 · Aug 18, 20262.1.50 · Aug 22, 20262.1.51 · Aug 22, 20262.1.52 · Aug 22, 20262.1.53 · Aug 27, 20262.1.54 · Aug 28, 20262.1.55 · Aug 31, 20262.1.56 · Aug 31, 20262.1.57 · Sep 2, 20262.1.58 · Sep 3, 20262.1.59 · Sep 6, 20262.1.60 · Sep 6, 20262.1.61 · Sep 9, 20262.1.62 · Sep 15, 20262.1.63 · Sep 16, 20262.1.64 · Sep 19, 20262.1.65 · Sep 22, 20262.1.66 · Sep 23, 20262.1.67 · Sep 28, 20262.1.68 · Oct 2, 20262.1.69 · Oct 3, 20262.1.70 · Oct 8, 20262.2.0 · Oct 8, 20262.2.1 · Oct 9, 20262.2.2 · Oct 11, 20262.2.3 · Oct 12, 20262.2.4 · Oct 12, 20262.2.5 · Oct 13, 20262.2.6 · Oct 14, 20262.3.0 · Oct 15, 20262.3.1 · Oct 15, 2026Apr 24, 2026Oct 15, 2026
VersionPublished
2.3.1Oct 15, 2026
2.3.0Oct 15, 2026
2.2.6Oct 14, 2026
2.2.5Oct 13, 2026
2.2.4Oct 12, 2026
2.2.3Oct 12, 2026
2.2.2Oct 11, 2026
2.2.1Oct 9, 2026
2.2.0Oct 8, 2026
2.1.70Oct 8, 2026
2.1.69Oct 3, 2026
2.1.68Oct 2, 2026
2.1.67Sep 28, 2026
2.1.66Sep 23, 2026
2.1.65Sep 22, 2026
2.1.64Sep 19, 2026
2.1.63Sep 16, 2026
2.1.62Sep 15, 2026
2.1.61Sep 9, 2026
2.1.60Sep 6, 2026
2.1.59Sep 6, 2026
2.1.58Sep 3, 2026
2.1.57Sep 2, 2026
2.1.56Aug 31, 2026
2.1.55Aug 31, 2026
2.1.54Aug 28, 2026
2.1.53Aug 27, 2026
2.1.52Aug 22, 2026
2.1.51Aug 22, 2026
2.1.50Aug 22, 2026
2.1.49Aug 18, 2026
2.1.48Aug 17, 2026
2.1.47Aug 16, 2026
2.1.46Aug 2, 2026
2.1.44Jul 29, 2026
2.1.43Jul 26, 2026
2.1.42Jul 19, 2026
2.1.41Jul 19, 2026
2.1.40Jul 16, 2026
2.1.39Jul 16, 2026
2.1.38Jul 14, 2026
2.1.30Jul 5, 2026
2.1.29Jul 3, 2026
2.1.28Jun 29, 2026
2.1.27Jun 22, 2026
2.1.26Jun 21, 2026
2.1.25Jun 20, 2026
2.1.24Jun 18, 2026
2.1.23Jun 17, 2026
2.1.22Jun 15, 2026
2.1.21Jun 14, 2026
2.1.20Jun 12, 2026
2.1.19Jun 11, 2026
2.1.18May 30, 2026
2.1.17May 30, 2026
2.1.16May 25, 2026
2.1.15May 24, 2026
2.1.14May 21, 2026
2.1.13May 20, 2026
2.1.12May 17, 2026
2.1.11May 13, 2026
2.1.10May 9, 2026
2.1.9May 7, 2026
2.1.8May 5, 2026
2.1.7May 5, 2026
2.1.6May 4, 2026
2.1.5May 3, 2026
2.1.4Apr 26, 2026
2.1.3Apr 24, 2026
STANDING
#12of 144,396 active serversTop 0.1%

Ranks ahead of 144,384 of 144,396 servers on MCP Toplist.

Recent momentum
+595GitHub stars since Apr 27 (+41%)
BADGE

Show your rank

Maintain this server? Add the live rank badge to your README — it updates automatically as the leaderboard changes.

MCP Toplist: Top 1% of 144,396
Markdown
[![MCP Toplist](https://mcptoplist.com/badge/io.github.zereight%2Fgitlab-mcp.svg)](https://mcptoplist.com/server/io.github.zereight%2Fgitlab-mcp)
HTML
<a href="https://mcptoplist.com/server/io.github.zereight%2Fgitlab-mcp"><img src="https://mcptoplist.com/badge/io.github.zereight%2Fgitlab-mcp.svg" alt="MCP Toplist: Top 1% of 144,396" /></a>

Variants: append ?metric=score or ?metric=stars to the image URL.

FAQ

Frequently asked questions

Who maintains gitlab-mcp?
gitlab-mcp is maintained by zereight, which publishes 4 MCP servers (69 total versions) tracked on MCP Toplist.
Is gitlab-mcp listed on the Official MCP Registry?
Yes — gitlab-mcp is listed on the Official MCP Registry, alongside Glama, PulseMCP and Smithery.
How many versions does gitlab-mcp have?
MCP Toplist tracks 69 versions of gitlab-mcp, most recently published on Oct 15, 2026.
Where can I find the source code for gitlab-mcp?
The source code for gitlab-mcp is hosted at github.com/zereight/gitlab-mcp.
Used in projects

Do you run this server?

Community projects list the MCP servers behind real agents and apps. Publish yours and this page will link to it.

EXPLORE