MCP server

GitLab MCP Server (community)

GitLab projects, merge requests, issues, pipelines and wikis, including self-hosted GitLab. Community-maintained (zereight on GitHub), not by the company whose product it connects to. It runs locally on your machine over stdio. Setup below for 12 clients (checked 2026-10-25). Repo and registry data checked 2026-10-24.

Maintainer: Community
Runs: Local (stdio)
Repo: zereight/gitlab-mcp
GitHub: ★ 2,064, last push 2026-10-24 (checked 2026-10-24)
License: MIT
Registry: io.github.zereight/gitlab-mcp
Connects to: GitLab

Install the GitLab MCP Server (community)

Pick your client. Each tab starts the same local command. Config shapes checked against each client's docs on 2026-10-25.

Run in a terminal. Everything after -- is the command that starts the server. docs

claude mcp add --transport stdio gitlab-community -- npx -y @zereight/mcp-gitlab

Claude Desktop only: Settings > Developer > Edit Config opens claude_desktop_config.json. Add this, save and restart the app. docs

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

Add to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (this project), or use the install button. docs

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

Add to Cursor

Add to .vscode/mcp.json (note the "servers" key and the type), or use the install button. Command Palette > "MCP: Open User Configuration" for all workspaces. docs

{
  "servers": {
    "gitlab-community": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ]
    }
  }
}

Add to VS Code

Run codex mcp add gitlab-community -- npx -y @zereight/mcp-gitlab, or add this to ~/.codex/config.toml. docs

[mcp_servers.gitlab-community]
command = "npx"
args = ["-y", "@zereight/mcp-gitlab"]

Run in a terminal (-s user adds it for all projects; the default is this project). docs

gemini mcp add -s user gitlab-community npx -- -y @zereight/mcp-gitlab

Run in a terminal; it writes ~/.copilot/mcp-config.json. docs

copilot mcp add gitlab-community -- npx -y @zereight/mcp-gitlab

Add to mcp_config.json: ~/.config/devin/mcp_config.json on macOS and Linux (older installs: ~/.codeium/windsurf/mcp_config.json), %APPDATA%\devin\ on Windows. docs

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

Add to Zed's settings.json (or Settings > AI > MCP Servers > Add Server). Remote servers without an Authorization header sign in with OAuth. docs

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

Add to opencode.json in the project (or ~/.config/opencode/opencode.json). docs

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "gitlab-community": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "enabled": true
    }
  }
}

Add to ~/.kiro/settings/mcp.json (all projects) or .kiro/settings/mcp.json (this project). docs

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

MCP Servers > Configure > Configure MCP Servers opens cline_mcp_settings.json; add this entry. docs

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

Security notes

The local server runs with your user's permissions (npx downloads it from npm on first run).
It can change code and repositories. Review what it writes before you push.
Community code: read it (or at least the tools it registers) before you give it credentials.

Alternatives

all developer tools & git MCP servers →

GitLabofficial
Issues, merge requests, pipelines and search for GitLab projects, built into GitLab.
GitHubofficial · ★ 34k
Repos, issues, pull requests, Actions, code scanning and Copilot coding agent, hosted or local.
Keployofficial · ★ 19k
Generate and run API tests from OpenAPI specs, curl commands, Postman collections or real traffic.
Mobilerunofficial · ★ 9.8k
Control real Android and iOS devices with an agent: tap, swipe, type and automate flows.
Azure DevOpsofficial · ★ 2.1k
Work items, repos, pull requests, pipelines and wikis in Azure DevOps.
MATLABofficial · ★ 1.7k
Run MATLAB code, tests and code analysis from a coding agent.
Docker MCP Gatewayofficial · ★ 1.6k
Run MCP servers in isolated containers behind one gateway, from the Docker MCP Catalog.
Salesforce DXofficial · ★ 486
Query Salesforce orgs, deploy metadata, run Apex tests and build Lightning Web Components.

FAQ

What does the GitLab MCP Server (community) do?+

GitLab projects, merge requests, issues, pipelines and wikis, including self-hosted GitLab.

Is the GitLab (community) MCP server official?+

Community-maintained (zereight on GitHub), not by the company whose product it connects to.

How do I add GitLab (community) to Claude Code?+

Run: claude mcp add gitlab-community -- npx -y @zereight/mcp-gitlab. Add --scope project to share it with your team through .mcp.json.

How do I use the GitLab (community) MCP server in Cursor or VS Code?+

Open the Cursor or VS Code tab above: it has the mcp.json entry and a one-click install link. Cursor uses the "mcpServers" key; VS Code uses "servers" and needs a type ("stdio").

Does GitLab (community) work in ChatGPT and claude.ai?+

No: it runs locally over stdio, and ChatGPT and claude.ai only connect to remote servers. Use it in Claude Desktop, Claude Code, Cursor, VS Code or another client that can start a local process.

What are the alternatives to the GitLab (community) MCP server?+

Other developer tools & git MCP servers: GitLab, GitHub, Keploy, Mobilerun and Azure DevOps.

All MCP servers · What is an MCP server? · Agent skills