GitLab MCP Installation

Choose the installation method that best fits your workflow.

Recommended: Setup Wizard

The fastest way to get started. The interactive wizard auto-detects your environment and configures everything:

npx @structured-world/gitlab-mcp setup

See Setup Wizard for a detailed walkthrough.

Installation Methods

Method	Best For	Guide
Setup Wizard	First-time setup, auto-configuration	Interactive, detects clients
npm / npx	Quick start, CI/CD	Minimal config, no install
Docker	Teams, server deployments	Isolated, scalable
Claude Desktop	Claude Desktop users	One-click .mcpb extension
VS Code	VS Code + GitHub Copilot users	One-click install
Codex	OpenAI Codex CLI users	Direct integration
Manual	Custom setups, advanced users	Full control

Optional: PostgreSQL session backend

The server ships as two npm packages. The core @structured-world/gitlab-mcp package (installed above) uses in-memory or file OAuth-session storage and needs no database. For multiple replicas behind a load balancer, the optional @structured-world/gitlab-mcp-db package persists OAuth sessions in PostgreSQL — enable it with OAUTH_STORAGE_TYPE=postgresql. See the PostgreSQL deployment guide for setup.

Prerequisites

• Node.js >= 24.0.0 (for npm/npx methods)
• GitLab Personal Access Token with api and read_user scopes
• One or more supported MCP clients

Next Steps

• Client-specific setup guides
• Deployment options
• Configuration reference