Skip to content

GitLab MCP Server

A comprehensive Model Context Protocol server for GitLab. Manage projects, merge requests, issues, pipelines, wikis, releases, tags, milestones, and more from any MCP-compatible AI client.

npm License

Why use this GitLab MCP?

  • Broad GitLab coverage — projects, repository browsing, merge requests, issues, pipelines, wiki, releases, tags, labels, milestones, and more.
  • Flexible auth — Personal Access Token, local OAuth2 browser flow, MCP OAuth proxy, and per-request remote authorization.
  • Multiple transports — stdio for local clients, SSE for legacy clients, and Streamable HTTP for modern remote deployments.
  • Client-friendly setup — examples for Claude Code, Codex, Antigravity, OpenCode, Copilot, Cline, Roo Code, Cursor, Kilo Code, and Amp Code.
  • Self-hosted ready — works with custom GitLab instances, proxy settings, and dynamic API URL routing.

Quick Start

Pick the auth method that fits your environment and drop it into your MCP client config.

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@zereight/mcp-gitlab"],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "glpat-xxxxxxxxxxxxxxxxxxxx",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@zereight/mcp-gitlab"],
      "env": {
        "GITLAB_USE_OAUTH": "true",
        "GITLAB_API_URL": "https://gitlab.com/api/v4"
      }
    }
  }
}

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab",
        "--token=glpat-xxxxxxxxxxxxxxxxxxxx",
        "--api-url=https://gitlab.com/api/v4"
      ]
    }
  }
}

See Getting Started for a full comparison of authentication methods.

Choose your client

Anthropic's terminal coding agent.

MCP support via VS Code's built-in client.

GitHub Copilot CLI with MCP integration.

The AI-first code editor.

OpenAI Codex CLI client.

Factory AI Droid, OpenClaw, OpenCode, and other generic clients.

Learn more

  • Tools Reference — complete catalog of every tool the MCP server exposes, grouped by category with read/write markers.
  • Authentication — OAuth2 setup, callback proxy, and multi-PAT configurations for custom agents.
  • Configuration — complete environment variable reference, dynamic API URLs, and stateless mode for multi-pod deployments.
  • Features — feature-specific guides such as resolving issue threads.
  • Reference — repository setup guides and design specs.