Advanced GitLab MCP server

Advanced GitLab MCP server

Advanced GitLab MCP server — 58 CQRS tools exposing 230 GitLab operations across 26 entity types. The tool catalog and parameters are filtered to each instance's GitLab version, tier, and token scopes, so the agent sees only what the connected instance actually supports.

Packages

This is a monorepo with two npm packages:

• @structured-world/gitlab-mcp — the MCP server. In-memory and file OAuth-session storage, no database dependency. This is all most users need.
• @structured-world/gitlab-mcp-db — optional PostgreSQL/Prisma OAuth-session backend for running multiple replicas behind a load balancer. Enable it with OAUTHSTORAGETYPE=postgresql; see the PostgreSQL deployment guide for the full setup.

Quick Start

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": ["-y", "@structured-world/gitlab-mcp"],
      "env": {
        "GITLAB_TOKEN": "your_gitlab_token",
        "GITLAB_API_URL": "https://gitlab.com"
      }
    }
  }
}

Requirements: Node.js >= 24

Highlights

• 58 tools across 26 entity types — projects, merge requests, pipelines, work items, wiki, and more
• CQRS architecture — browse for queries, manage for commands
• Connection resilience — Bounded startup, auto-reconnect with exponential backoff, disconnected mode when GitLab is unreachable
• Multi-instance support — Connect to GitLab.com, self-managed, and self-hosted instances with per-instance OAuth and rate limiting
• Multiple transports — stdio, SSE, StreamableHTTP
• OAuth 2.1 — Per-user authentication via Claude Custom Connector
• Read-only mode — Safe operation for production environments
• Auto-discovery — Detects GitLab config from git remotes
• Fine-grained control — Enable/disable tool groups, filter actions, customize descriptions
• Docker support — ghcr.io/structured-world/gitlab-mcp:latest

Tool model

Shortened. The full README is on GitHub.