GitLab MCP - install, status & alternatives [2026]

01 · Install GitLab MCP

before you install - you'll need

Set STREAMABLE_HTTP, GITLAB_MCP_OAUTH, GITLAB_OAUTH_APP_ID, GITLAB_API_URL, GITLAB_PERSONAL_ACCESS_TOKEN, GITLAB_TOOLSETS, SSE_AUTH_TOKEN, REMOTE_AUTHORIZATION before connecting. MCP_SERVER_URL, GITLAB_PERMISSION_MODE, GITLAB_OAUTH_CALLBACK_PROXY, SESSION_TIMEOUT_SECONDS are optional or environment-specific per the README.

Claude Code

claude mcp add zereight-gitlab-mcp -- npx -y @zereight/mcp-gitlab

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "zereight-gitlab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @zereight/mcp-gitlab - published under the repo owner's npm scope (@zereight)

registry namespace io.github.zereight is GitHub-verified and matches the repo owner

03 · What GitLab MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can get merge request approval details including approvers, get the conflicts of a merge request, list pipelines for a merge request with pagination, and execute a GitLab GraphQL query.

Capability map

Tools grouped from the project's README - what GitLab MCP lets an agent do.

Merge

19 tools - e.g. Merge a merge request; Approve a merge request; Unapprove a merge request

merge_merge_request · approve_merge_request · unapprove_merge_request · get_merge_request_approval_state · get_merge_request_conflicts · list_merge_request_pipelines…

Branch

8 tools - e.g. Create a new branch; Get branch details (commit, protection status); Delete branch from project

create_branch · get_branch · delete_branch · get_protected_branch · protect_branch · unprotect_branch…

create & write

4 tools - e.g. Create a new GitLab project; Create new group or subgroup; Create a new issue

create_repository · create_group · create_issue · create_note

File

2 tools - e.g. Create or update a file in a GitLab project; Get contents of a file or directory from a GitLab project

create_or_update_file · get_file_contents

read & search

2 tools - e.g. Search for GitLab projects; List branches in project with search filter

search_repositories · list_branches

run & execute

1 tool - e.g. Execute a GitLab GraphQL query

execute_graphql

Push

1 tool - e.g. Push multiple files in a single commit

push_files

Fork

1 tool - e.g. Fork a project to your account or specified namespace

fork_repository

Latest releases

v2.1.63 · 2026-09-16

Changes in v2.1.63 · - feat: add get_merge_request_discussion tool #750 · - feat: add configurable response masking for sensitive GitLab data #751 · - chore(homebrew): sync formula for release #749 · Contributors…

v2.1.62 · 2026-09-15

Changes in v2.1.62 · - feat: health check with mcp server version #742 · - feat: upgrade zod 3 to 4 for faster parsing #747 · - docs: sync README and skill with tool registry #739 · - docs: update Star History chart…

v2.1.61 · 2026-09-09

Changes in v2.1.61 · - fix: hint issue-tool classification for Copilot #737 · - docs: sync README and skill with tool registry #735 · - chore(homebrew): sync formula for release #733 · Contributors · @zereight (2 PRs…

04 · Who maintains GitLab MCP

gitlab-mcp is maintained by zereight. It's the only MCP server we track from this author; the repo dates to Feb 2025.

05 · Facts

repository: github.com/zereight/gitlab-mcp
category: documentation - ranked #2 of 208 actively-maintained documentation servers as of 2026-09-18.
release cadence: 10+ releases in the last 90 days (latest 2026-09-16)
registry: io.github.zereight/gitlab-mcp (active, first published 2026-04-24 · 53 versions)
packages: npm:@zereight/mcp-gitlab

06 · GitLab MCP FAQ

Is GitLab MCP still maintained?

Yes - as of 2026-09-18, its last commit was 2026-09-16 and it shipped 10+ releases in the last 90 days. We re-verify nightly.

What can GitLab MCP do?

With this server connected, an agent can get merge request approval details including approvers, get the conflicts of a merge request, list pipelines for a merge request with pagination, and execute a GitLab GraphQL query.

How do I install GitLab MCP?

Run `npx -y @zereight/mcp-gitlab`. The README documents 12 environment variables (STREAMABLE_HTTP, GITLAB_MCP_OAUTH, GITLAB_OAUTH_APP_ID…) to set first. Set STREAMABLE_HTTP, GITLAB_MCP_OAUTH, GITLAB_OAUTH_APP_ID, GITLAB_API_URL, GITLAB_PERSONAL_ACCESS_TOKEN, GITLAB_TOOLSETS, SSE_AUTH_TOKEN, REMOTE_AUTHORIZATION before connecting. MCP_SERVER_URL, GITLAB_PERMISSION_MODE, GITLAB_OAUTH_CALLBACK_PROXY, SESSION_TIMEOUT_SECONDS are optional or environment-specific per the README. You can also paste the ready-made client config above.

Does GitLab MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to GitLab MCP

Alternatives to GitLab MCP

Maintained documentation servers if GitLab MCP isn't the fit.

Pairs well with

Servers that cover what GitLab MCP doesn't - only shown when the pairing reason fits the companion.

head to head · Context7 vs GitLab MCP · Svelte MCP vs GitLab MCP · Appwrite MCP Server vs GitLab MCP

More documentation MCP servers · Llmmcp · 1inch MCP · DaVinci Resolve Lite MCP · Multi-account MCP for Gmail, Calendar, Drive, Docs, and Sheets - 61 tools, token · Mason

More TypeScript MCP servers · Draw2agent · Zeta Chain CLI · Tweetsave MCP · iFlow Search · see all