Keyflow
Contact

Search Keyflow

Find a shortcut, workflow, MCP server or skill

gitlab-mcp

local MCP server

gitlab-mcp is a local MCP server: GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more. Install it from npm as @zereight/mcp-gitlab.

Installation

Terminal

claude mcp add io-github-zereight-gitlab-mcp -e GITLAB_PERSONAL_ACCESS_TOKEN=... -e GITLAB_JOB_TOKEN=... -e GITLAB_AUTH_COOKIE_PATH=... -e GITLAB_API_URL=... -e GITLAB_ALLOWED_PROJECT_IDS=... -e GITLAB_READ_ONLY_MODE=... -e USE_GITLAB_WIKI=... -e GITLAB_TOOLSETS=... -e GITLAB_TOOLS=... -e GITLAB_DENIED_TOOLS_REGEX=... -e GITLAB_TOOL_POLICY_APPROVE=... -e GITLAB_TOOL_POLICY_HIDDEN=... -e NODE_TLS_REJECT_UNAUTHORIZED=... -e GITLAB_CA_CERT_PATH=... -e GITLAB_MASKING_ENABLED=... -e GITLAB_MASKING_CONFIG=... -e GITLAB_MASKING_POLICY_FILE=... -e GITLAB_MASKING_WORKSPACE_DIR=... -- npx -y @zereight/mcp-gitlab

Run in your project folder. Add --scope user to use it everywhere.

Claude Desktop, Cursor & other clients

Add to claude_desktop_config.json or .cursor/mcp.json.

{
  "mcpServers": {
    "io-github-zereight-gitlab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "...",
        "GITLAB_JOB_TOKEN": "...",
        "GITLAB_AUTH_COOKIE_PATH": "...",
        "GITLAB_API_URL": "...",
        "GITLAB_ALLOWED_PROJECT_IDS": "...",
        "GITLAB_READ_ONLY_MODE": "...",
        "USE_GITLAB_WIKI": "...",
        "GITLAB_TOOLSETS": "...",
        "GITLAB_TOOLS": "...",
        "GITLAB_DENIED_TOOLS_REGEX": "...",
        "GITLAB_TOOL_POLICY_APPROVE": "...",
        "GITLAB_TOOL_POLICY_HIDDEN": "...",
        "NODE_TLS_REJECT_UNAUTHORIZED": "...",
        "GITLAB_CA_CERT_PATH": "...",
        "GITLAB_MASKING_ENABLED": "...",
        "GITLAB_MASKING_CONFIG": "...",
        "GITLAB_MASKING_POLICY_FILE": "...",
        "GITLAB_MASKING_WORKSPACE_DIR": "..."
      }
    }
  }
}

Fill in the environment variables with your own credentials.

What you need

  • Runtime: Node.js 18+ (runs with npx).
  • MCP client: Claude Code, Codex, Antigravity, Claude Desktop, Cursor or any other client that speaks MCP over stdio.
  • Environment variables: GITLAB_PERSONAL_ACCESS_TOKEN, GITLAB_JOB_TOKEN, GITLAB_AUTH_COOKIE_PATH, GITLAB_API_URL, GITLAB_ALLOWED_PROJECT_IDS, GITLAB_READ_ONLY_MODE, USE_GITLAB_WIKI, GITLAB_TOOLSETS, GITLAB_TOOLS, GITLAB_DENIED_TOOLS_REGEX, GITLAB_TOOL_POLICY_APPROVE, GITLAB_TOOL_POLICY_HIDDEN, NODE_TLS_REJECT_UNAUTHORIZED, GITLAB_CA_CERT_PATH, GITLAB_MASKING_ENABLED, GITLAB_MASKING_CONFIG, GITLAB_MASKING_POLICY_FILE, GITLAB_MASKING_WORKSPACE_DIR

Summary

GitLab MCP server for projects, merge requests, issues, pipelines, wiki, releases, and more.

gitlab-mcp vs similar servers

ServerStarsTypeAPI keyRuntime
gitlab-mcp2,007LocalYesnpm
gitlab31LocalNopypi
gk-cli462LocalNonpm
kaneo9,252LocalYesnpm
DBHub3,574LocalYesnpm

Questions

It reads 18 environment variables: GITLAB_PERSONAL_ACCESS_TOKEN, GITLAB_JOB_TOKEN, GITLAB_AUTH_COOKIE_PATH, GITLAB_API_URL, GITLAB_ALLOWED_PROJECT_IDS, GITLAB_READ_ONLY_MODE, USE_GITLAB_WIKI, GITLAB_TOOLSETS, GITLAB_TOOLS, GITLAB_DENIED_TOOLS_REGEX, GITLAB_TOOL_POLICY_APPROVE, GITLAB_TOOL_POLICY_HIDDEN, NODE_TLS_REJECT_UNAUTHORIZED, GITLAB_CA_CERT_PATH, GITLAB_MASKING_ENABLED, GITLAB_MASKING_CONFIG, GITLAB_MASKING_POLICY_FILE, GITLAB_MASKING_WORKSPACE_DIR. Set them in your MCP config before starting the server.

Node.js 18+ (runs with npx), plus an MCP client such as Claude Code, Codex, Claude Desktop or Cursor.

gitlab-mcp is a local MCP server distributed as the npm package @zereight/mcp-gitlab.

Run: claude mcp add io-github-zereight-gitlab-mcp -e GITLAB_PERSONAL_ACCESS_TOKEN=... -e GITLAB_JOB_TOKEN=... -e GITLAB_AUTH_COOKIE_PATH=... -e GITLAB_API_URL=... -e GITLAB_ALLOWED_PROJECT_IDS=... -e GITLAB_READ_ONLY_MODE=... -e USE_GITLAB_WIKI=... -e GITLAB_TOOLSETS=... -e GITLAB_TOOLS=... -e GITLAB_DENIED_TOOLS_REGEX=... -e GITLAB_TOOL_POLICY_APPROVE=... -e GITLAB_TOOL_POLICY_HIDDEN=... -e NODE_TLS_REJECT_UNAUTHORIZED=... -e GITLAB_CA_CERT_PATH=... -e GITLAB_MASKING_ENABLED=... -e GITLAB_MASKING_CONFIG=... -e GITLAB_MASKING_POLICY_FILE=... -e GITLAB_MASKING_WORKSPACE_DIR=... -- npx -y @zereight/mcp-gitlab

Run: codex mcp add io-github-zereight-gitlab-mcp --env GITLAB_PERSONAL_ACCESS_TOKEN=... --env GITLAB_JOB_TOKEN=... --env GITLAB_AUTH_COOKIE_PATH=... --env GITLAB_API_URL=... --env GITLAB_ALLOWED_PROJECT_IDS=... --env GITLAB_READ_ONLY_MODE=... --env USE_GITLAB_WIKI=... --env GITLAB_TOOLSETS=... --env GITLAB_TOOLS=... --env GITLAB_DENIED_TOOLS_REGEX=... --env GITLAB_TOOL_POLICY_APPROVE=... --env GITLAB_TOOL_POLICY_HIDDEN=... --env NODE_TLS_REJECT_UNAUTHORIZED=... --env GITLAB_CA_CERT_PATH=... --env GITLAB_MASKING_ENABLED=... --env GITLAB_MASKING_CONFIG=... --env GITLAB_MASKING_POLICY_FILE=... --env GITLAB_MASKING_WORKSPACE_DIR=... -- npx -y @zereight/mcp-gitlab

Similar MCP servers

NameStars
  1. gitlabcom.mcparmory/gitlab31
  2. gk-clicom.gitkraken/gk-cli462
  3. kaneoio.github.usekaneo/kaneo9,252
  4. DBHubio.github.bytebase/dbhub3,574
  5. Neoncom.neon/mcp649
  6. touchdesigner-mcp-serverio.github.8beeeaaat/touchdesigner-mcp-server552
  7. mcp-ssh-managerio.github.bvisible/mcp-ssh-manager493
  8. Nim Language Serverio.github.nim-lang/nimlangserver311