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

{ "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

• 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

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

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.

# 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

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

Apache License 2.0 — see LICENSE for details.

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