MCP Server

Advanced GitLab MCP server MCP Server

Name: Advanced GitLab MCP server MCP Server
Author: io.github.structured-world

io.github.structured-world/gitlab-mcp

Repository Registry

What is the Advanced GitLab MCP server MCP server?

58 CQRS tools exposing 230 GitLab operations across 26 entity types

How to install Advanced GitLab MCP server

Copy-paste configuration for popular MCP clients.

transport: stdio

Config generated by PluginBench — verify against the source before use.

Environment / auth

GITLAB_TOKEN
required
secret
GitLab Personal Access Token with 'api' and 'read_user' scopes
GITLAB_API_URL
GitLab instance API URL for self-hosted instances (defaults to https://gitlab.com)
GITLAB_READ_ONLY_MODE
Enable read-only mode (disable all manage_* write operations)

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "gitlab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@structured-world/gitlab-mcp"
      ],
      "env": {
        "GITLAB_TOKEN": "<YOUR_GITLAB_TOKEN>",
        "GITLAB_API_URL": "<YOUR_GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<YOUR_GITLAB_READ_ONLY_MODE>"
      }
    }
  }
}

Cursor

~/.cursor/mcp.json

{
  "mcpServers": {
    "gitlab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@structured-world/gitlab-mcp"
      ],
      "env": {
        "GITLAB_TOKEN": "<YOUR_GITLAB_TOKEN>",
        "GITLAB_API_URL": "<YOUR_GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<YOUR_GITLAB_READ_ONLY_MODE>"
      }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "gitlab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@structured-world/gitlab-mcp"
      ],
      "env": {
        "GITLAB_TOKEN": "<YOUR_GITLAB_TOKEN>",
        "GITLAB_API_URL": "<YOUR_GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<YOUR_GITLAB_READ_ONLY_MODE>"
      }
    }
  }
}

VS Code

.vscode/mcp.json

{
  "servers": {
    "gitlab-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@structured-world/gitlab-mcp"
      ],
      "env": {
        "GITLAB_TOKEN": "<YOUR_GITLAB_TOKEN>",
        "GITLAB_API_URL": "<YOUR_GITLAB_API_URL>",
        "GITLAB_READ_ONLY_MODE": "<YOUR_GITLAB_READ_ONLY_MODE>"
      }
    }
  }
}

Claude Code

claude mcp add gitlab-mcp --env GITLAB_TOKEN=<YOUR_GITLAB_TOKEN> --env GITLAB_API_URL=<YOUR_GITLAB_API_URL> --env GITLAB_READ_ONLY_MODE=<YOUR_GITLAB_READ_ONLY_MODE> -- npx -y @structured-world/gitlab-mcp