MCP.so
Sign In

GitLab MCP Server

@yoda-digital

Basic information

Category

Version Control

License

MIT

Transports

stdio

Author

yoda-digital

About GitLab MCP Server

Production-grade GitLab MCP server with 86 tools — full GitLab control from any AI agent (Claude, Cursor, Zed).

GitLab MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-gitlab-server": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-p",
        "3000:3000",
        "\\"
      ]
    }
  }
}

GitLab MCP Server tools

Tool list not available yet

This listing does not currently have a tool list to display. This does not mean the server has no tools; check its documentation for supported capabilities.

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is GitLab MCP Server?

The GitLab MCP Server is a typed, paginated, schema-validated bridge from the Model Context Protocol (MCP) to the GitLab REST API, exposing 86 tools for AI agents. It works with gitlab.com or any self-hosted GitLab instance and authenticates via personal access token, OAuth Bearer token, or read‑only mode.

How to use GitLab MCP Server?

Install and run with npx -y @yoda.digital/gitlab-mcp-server or the Docker image ghcr.io/yoda-digital/mcp-gitlab-server. Configure environment variables GITLAB_PERSONAL_ACCESS_TOKEN and GITLAB_API_URL (default https://gitlab.com/api/v4). Add the server to your MCP client config (e.g., claude_desktop_config.json) as a subprocess. For remote deployments, run the HTTP service with AUTH_MODE=oauth and front it with a gateway.

Key features of GitLab MCP Server

  • 86 typed, paginated, schema‑validated MCP tools.
  • Works with GitLab SaaS and self‑hosted instances.
  • Authentication modes: PAT, OAuth per connection, read‑only.
  • Supports stdio, legacy SSE, and Streamable HTTP transports.
  • Read‑only mode hides all mutating tools at registration.
  • Docker image and Helm chart with security hardening.

Use cases of GitLab MCP Server

  • AI coding assistant managing merge requests, pipelines, and code reviews.
  • Automated CI/CD monitoring and incident response via agent workflows.
  • Developer querying project wikis, issues, and commit history in natural language.
  • Shared OAuth‑gated MCP gateway for an entire DevOps team.
  • Safe demo or exploration with read‑only access enforced at tool registration.

Frequently asked questions

1

How does this compare to other GitLab MCP servers?

GitLab’s built‑in MCP server offers 15 tools and requires GitLab Premium/Ultimate. `zereight/gitlab-mcp` has broader auth surface and more tools. `mcpland/gitlab-mcp` focuses on a policy‑engine. This server provides 86 tools with PAT, OAuth, and read‑only modes, and runs on any GitLab instance.

2

What runtime does the server require?

The server runs on Node.js (published as an npm package) or as a Docker container based on `node:24-alpine`. The Docker image runs as non‑root (uid 1000) with all capabilities dropped.

3

Can the server be used in read‑only mode?

Yes. Set `GITLAB_READ_ONLY_MODE=true` to filter every mutating tool out at registration time. A misbehaving agent cannot see or call write tools.

4

What transport protocols are supported?

Three transports: stdio (default for local clients), legacy SSE (`USE_SSE=true`), and Streamable HTTP (`USE_STREAMABLE_HTTP=true`). Streamable HTTP provides `POST /mcp`, `GET /mcp`, `DELETE /mcp`, and a `/healthz` endpoint.

5

How does authentication work for remote deployments?

Remote HTTP deployments must use `AUTH_MODE=oauth` (the server refuses to start with PAT mode on a non‑loopback bind). Each MCP connection brings its own `Authorization: Bearer <token>`, which the server forwards as the effective PAT for that connection.

Comments

More Version Control MCP servers