Advanced GitLab MCP server

Advanced GitLab MCP server — 44 tools across 18 entity types with CQRS architecture, OAuth 2.1, and multiple transport modes.

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

• 44 tools across 18 entity types — projects, merge requests, pipelines, work items, wiki, and more
• CQRS architecture — browse_* for queries, manage_* for commands
• Multi-instance support — Connect to multiple GitLab 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

Documentation

Full documentation is available at gitlab-mcp.sw.foundation

| Section | Description | |---------|-------------| | Installation | npm, Docker, VS Code, Codex | | Configuration | Environment variables, feature flags | | Multi-Instance | Connect to multiple GitLab instances | | Tool Reference | All 44 tools with parameters | | OAuth Setup | Team authentication with Claude | | TLS/HTTPS | Production deployment with SSL | | Customization | Tool descriptions, action filtering | | CLI Tools | Browse and export tool documentation |

Auto-generated Tool Reference

For the complete tool reference with parameters:

# View locally
yarn list-tools --detail

# Generate documentation
yarn list-tools --export --toc > docs/tools/api-reference.md

See the Full API Reference for the auto-generated tool documentation.

Docker

# HTTP mode
docker run -e PORT=3002 -e GITLAB_TOKEN=your_token -p 3333:3002 \
  ghcr.io/structured-world/gitlab-mcp:latest

# stdio mode
docker run -i --rm -e GITLAB_TOKEN=your_token \
  ghcr.io/structured-world/gitlab-mcp:latest

Feature Flags

| Flag | Default | Tools Enabled | |------|---------|---------------| | USE_LABELS | true | Label management | | USE_MRS | true | Merge requests | | USE_FILES | true | File operations | | USE_VARIABLES | true | CI/CD variables | | USE_WORKITEMS | true | Issues, epics, tasks | | USE_WEBHOOKS | true | Webhook management | | USE_SNIPPETS | true | Code snippets | | USE_INTEGRATIONS | true | 50+ integrations | | USE_GITLAB_WIKI | true | Wiki pages | | USE_MILESTONE | true | Milestones | | USE_PIPELINE | true | Pipelines & CI/CD | | USE_RELEASES | true | Release management | | USE_REFS | true | Branch & tag management | | USE_MEMBERS | true | Team members | | USE_SEARCH | true | Cross-project search | | USE_ITERATIONS | true | Iteration planning (sprints) |

Contributing

See CONTRIBUTING.md for development setup, testing, and PR guidelines.

Support the Project

USDT (TRC-20): TFDsezHa1cBkoeZT5q2T49Wp66K8t2DmdA

License

Apache License 2.0 — see LICENSE for details.

Based on zereight/gitlab-mcp (MIT). See LICENSE.MIT.