GitLab MCP Server

io.github.zereight/gitlab-mcpv2.3.15Git & Code Hosting

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

The current version, v2.3.15, was published to the official MCP registry on 2026-10-29. It is distributed as @zereight/mcp-gitlab on npm and as the Docker image docker.io/zereight050/gitlab-mcp:2.3.15, filed under Git & Code Hosting by this index, and declares 21 environment variables. Removals and unreachable sources are measured across every server this index tracks, contract drift across the servers that answer in consecutive snapshots; the index's current counts put this record in context.

In-path gate · all MCP tools

Using GitLab MCP Server in Claude, Cursor, Gemini CLI, Cline, or Zed?

MCP tool contracts can change remotely with no version bump. The mcpindex gate pins each contract and HOLDs the call when it drifts-before your agent acts. Zero credentials. This is not the package install for this server itself (use Install this server for that).

Install the mcpindex gate (one command)

Rewrites your MCP host config so each server launches behind the gate. Inspect first: curl -fsSL https://mcpindex.ai/install.sh | less

uv tool install mcpindex-gate && mcpindex-config-wire

Auditable install path →Watch it hold a drift →

Trust verdict · v1 advisory · method

REVIEWstatus: PARTIALfresh until 2026-11-05 16:56 UTC

screened 2026-10-03tier: scannedgranularity: description-levelsource: registry

Semantic screen found no manipulation pattern in the description. Conformance probe not yet run.

mcpindex.integrity.descriptionpassINFO

evidence“Normal capability description”via static_description

Limits of this verdict

- Semantic screen only - the deterministic conformance probe has not run on this server
- Confidence is reported but not yet calibrated (v1)
- Screen reads the tool description, not the live behavior
- advisory
- registry description only no input schema
- screen model 8b
- Still current: the description we screened is unchanged, re-checked against the registry
- The registry listing (version, packages, links) changed after this screen ran - the description we assessed did not

Semantic screen: an LLM judge reads the tool description for hidden instructions (status PARTIAL). A pass means the description is not lying, not that the tool is safe: a high-capability tool with an honest description still warrants caution. The deterministic conformance probe has not been run on this server yet, so the screen here is semantic-only. Posture: advisory. Confidences are reported but not yet calibrated (calibrated=false at v1). Full verdict history is not shown on this page.

Own this server? Test a description on the public screen → It is a separate check from the verdict above, so the two can differ.

That verdict was true at screening time (snapshot 2026-10-29).

Contracts can change after screening, with no version bump. The gate pins GitLab MCP Server’s tool contracts on first sight and holds any silent change before your agent acts - the check that keeps being true on Tuesday.

See your first HOLD in 2 minutes →

Cite this record

People vet a server before wiring it in. One line on your project site or docs answers that with an independent record: screening verdict, registry provenance, contract drift history. It stays current as new screens and drift events land.

Markdown

[Independent trust record for GitLab MCP Server](https://mcpindex.ai/server/io-github-zereight-gitlab-mcp) - screening verdict, registry provenance, and contract drift monitoring.

HTML

<a href="https://mcpindex.ai/server/io-github-zereight-gitlab-mcp">Independent trust record for GitLab MCP Server</a> - screening verdict, registry provenance, and contract drift monitoring.

Embed this badge

A live verdict badge for your README or listing. It reflects the current screen, links back here, and updates when the verdict does.

Markdown

[![mcpindex](https://mcpindex.ai/api/v1/badge/io-github-zereight-gitlab-mcp)](https://mcpindex.ai/server/io-github-zereight-gitlab-mcp)

HTML

<a href="https://mcpindex.ai/server/io-github-zereight-gitlab-mcp"><img src="https://mcpindex.ai/api/v1/badge/io-github-zereight-gitlab-mcp" alt="mcpindex verdict" height="20" /></a>

Environment variables

GITLAB_PERSONAL_ACCESS_TOKEN

secret

GitLab personal access token for local stdio use. A non-empty value overrides GITLAB_PERSONAL_ACCESS_TOKEN_FILE. One of this token, GITLAB_PERSONAL_ACCESS_TOKEN_FILE, GITLAB_JOB_TOKEN, GITLAB_AUTH_COOKIE_PATH, or GITLAB_USE_OAUTH=true must be set. Create a token with the GitLab scopes the tools need, such as api or read_api.

GITLAB_PERSONAL_ACCESS_TOKEN_FILE

Path to a file that contains the personal access token. Read once at startup and trimmed. Ignored when GITLAB_PERSONAL_ACCESS_TOKEN or --token is non-empty. A missing, unreadable, or empty file stops startup. Does not replace job token, OAuth, cookie, or remote authorization.

GITLAB_JOB_TOKEN

secret

Optional GitLab CI job token to use instead of a personal access token when running inside GitLab CI.

GITLAB_AUTH_COOKIE_PATH

Optional path to a GitLab authentication cookie file for cookie-based authentication.

GITLAB_USE_OAUTH

Set to true to start with GitLab OAuth instead of a personal access token, job token, or cookie file.

GITLAB_OAUTH_CLIENT_ID

GitLab OAuth application ID. When GITLAB_USE_OAUTH=true, set this or GITLAB_OAUTH_TOKEN_SCRIPT.

GITLAB_OAUTH_TOKEN_SCRIPT

Command that prints an OAuth access token. When GITLAB_USE_OAUTH=true, set this or GITLAB_OAUTH_CLIENT_ID.

GITLAB_API_URL

GitLab API base URL. Use https://gitlab.com/api/v4 for GitLab.com or your self-managed GitLab API URL.

GITLAB_ALLOWED_PROJECT_IDS

Optional comma-separated list of GitLab project IDs that this server is allowed to access.

GITLAB_PERMISSION_MODE

Tool exposure. Allowed values are readonly, modify, and full. Unset uses full. readonly keeps read-only tools. modify blocks delete and teardown tools.

GITLAB_TOOLSETS

Optional comma-separated list of toolsets to enable, such as projects, issues, merge_requests, pipelines, releases, users, groups, wiki, or search.

GITLAB_TOOLS

Optional comma-separated list of individual tool names to add on top of enabled toolsets.

GITLAB_DENIED_TOOLS_REGEX

Optional regular expression used to hide matching tools from the server.

GITLAB_TOOL_POLICY_APPROVE

Optional comma-separated list of tool names that require explicit approval before execution.

GITLAB_TOOL_POLICY_HIDDEN

Optional comma-separated list of tool names to hide from tools/list.

NODE_TLS_REJECT_UNAUTHORIZED

Set to 0 only when you intentionally need to connect to a GitLab instance with invalid or self-signed TLS certificates.

GITLAB_CA_CERT_PATH

Optional path to a custom CA certificate file for self-managed GitLab instances.

GITLAB_MASKING_ENABLED

Set to true to mask text tool results and returned errors using built-in or configured rules.

GITLAB_MASKING_CONFIG

Optional path to a response-masking JSON configuration file.

GITLAB_MASKING_POLICY_FILE

Optional protected server-owned JSON file containing managed masking policies.

GITLAB_MASKING_WORKSPACE_DIR

Directory used to resolve response-masking configuration paths.

GITLAB_PERSONAL_ACCESS_TOKEN

secret

GITLAB_PERSONAL_ACCESS_TOKEN_FILE

GITLAB_JOB_TOKEN

secret

Optional GitLab CI job token to use instead of a personal access token when running inside GitLab CI.

GITLAB_AUTH_COOKIE_PATH

Optional path to a GitLab authentication cookie file for cookie-based authentication.

GITLAB_USE_OAUTH

Set to true to start with GitLab OAuth instead of a personal access token, job token, or cookie file.

GITLAB_OAUTH_CLIENT_ID

GitLab OAuth application ID. When GITLAB_USE_OAUTH=true, set this or GITLAB_OAUTH_TOKEN_SCRIPT.

GITLAB_OAUTH_TOKEN_SCRIPT

Command that prints an OAuth access token. When GITLAB_USE_OAUTH=true, set this or GITLAB_OAUTH_CLIENT_ID.

GITLAB_API_URL

GitLab API base URL. Use https://gitlab.com/api/v4 for GitLab.com or your self-managed GitLab API URL.

GITLAB_ALLOWED_PROJECT_IDS

Optional comma-separated list of GitLab project IDs that this server is allowed to access.

GITLAB_PERMISSION_MODE

Tool exposure. Allowed values are readonly, modify, and full. Unset uses full. readonly keeps read-only tools. modify blocks delete and teardown tools.

GITLAB_TOOLSETS

Optional comma-separated list of toolsets to enable, such as projects, issues, merge_requests, pipelines, releases, users, groups, wiki, or search.

GITLAB_TOOLS

Optional comma-separated list of individual tool names to add on top of enabled toolsets.

GITLAB_DENIED_TOOLS_REGEX

Optional regular expression used to hide matching tools from the server.

GITLAB_TOOL_POLICY_APPROVE

Optional comma-separated list of tool names that require explicit approval before execution.

GITLAB_TOOL_POLICY_HIDDEN

Optional comma-separated list of tool names to hide from tools/list.

NODE_TLS_REJECT_UNAUTHORIZED

Set to 0 only when you intentionally need to connect to a GitLab instance with invalid or self-signed TLS certificates.

GITLAB_CA_CERT_PATH

Optional path to a custom CA certificate file for self-managed GitLab instances.

GITLAB_MASKING_ENABLED

Set to true to mask text tool results and returned errors using built-in or configured rules.

GITLAB_MASKING_CONFIG

Optional path to a response-masking JSON configuration file.

GITLAB_MASKING_POLICY_FILE

Optional protected server-owned JSON file containing managed masking policies.

GITLAB_MASKING_WORKSPACE_DIR

Directory used to resolve response-masking configuration paths.

MCP quality score · maturity, not trust · methodology

freshness

completeness

installability

documentation

stability

Alternatives in Git & Code Hosting

Faable — Deploy & Auth

com.faable/mcp

Deploy apps from GitHub, read build/runtime logs, and manage your app's users from your AI agent.

AgentDiet Coding Agent GitHub Repo, Dependency & License Security Auditor

dev.agentdiet/github-audit

Evaluates any GitHub repository for license risk, maintenance velocity, stars/forks, and supply-c.

GitHub Release MCP

io.github.zishuowang696/gh-release-mcp

List and download GitHub release assets with multi-mirror parallel ranged download.

Install this server

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "gitlab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "--",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<your-gitlab_personal_access_token>",
        "GITLAB_PERSONAL_ACCESS_TOKEN_FILE": "<gitlab_personal_access_token_file>",
        "GITLAB_JOB_TOKEN": "<your-gitlab_job_token>",
        "GITLAB_AUTH_COOKIE_PATH": "<gitlab_auth_cookie_path>",
        "GITLAB_USE_OAUTH": "<gitlab_use_oauth>",
        "GITLAB_OAUTH_CLIENT_ID": "<gitlab_oauth_client_id>",
        "GITLAB_OAUTH_TOKEN_SCRIPT": "<gitlab_oauth_token_script>",
        "GITLAB_API_URL": "https://gitlab.com/api/v4",
        "GITLAB_ALLOWED_PROJECT_IDS": "<gitlab_allowed_project_ids>",
        "GITLAB_PERMISSION_MODE": "<gitlab_permission_mode>",
        "GITLAB_TOOLSETS": "<gitlab_toolsets>",
        "GITLAB_TOOLS": "<gitlab_tools>",
        "GITLAB_DENIED_TOOLS_REGEX": "<gitlab_denied_tools_regex>",
        "GITLAB_TOOL_POLICY_APPROVE": "<gitlab_tool_policy_approve>",
        "GITLAB_TOOL_POLICY_HIDDEN": "<gitlab_tool_policy_hidden>",
        "NODE_TLS_REJECT_UNAUTHORIZED": "<node_tls_reject_unauthorized>",
        "GITLAB_CA_CERT_PATH": "<gitlab_ca_cert_path>",
        "GITLAB_MASKING_ENABLED": "false",
        "GITLAB_MASKING_CONFIG": "<gitlab_masking_config>",
        "GITLAB_MASKING_POLICY_FILE": "<gitlab_masking_policy_file>",
        "GITLAB_MASKING_WORKSPACE_DIR": "<gitlab_masking_workspace_dir>"
      }
    }
  }
}

Cursor (.cursor/mcp.json)

{
  "mcpServers": {
    "gitlab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "--",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<your-gitlab_personal_access_token>",
        "GITLAB_PERSONAL_ACCESS_TOKEN_FILE": "<gitlab_personal_access_token_file>",
        "GITLAB_JOB_TOKEN": "<your-gitlab_job_token>",
        "GITLAB_AUTH_COOKIE_PATH": "<gitlab_auth_cookie_path>",
        "GITLAB_USE_OAUTH": "<gitlab_use_oauth>",
        "GITLAB_OAUTH_CLIENT_ID": "<gitlab_oauth_client_id>",
        "GITLAB_OAUTH_TOKEN_SCRIPT": "<gitlab_oauth_token_script>",
        "GITLAB_API_URL": "https://gitlab.com/api/v4",
        "GITLAB_ALLOWED_PROJECT_IDS": "<gitlab_allowed_project_ids>",
        "GITLAB_PERMISSION_MODE": "<gitlab_permission_mode>",
        "GITLAB_TOOLSETS": "<gitlab_toolsets>",
        "GITLAB_TOOLS": "<gitlab_tools>",
        "GITLAB_DENIED_TOOLS_REGEX": "<gitlab_denied_tools_regex>",
        "GITLAB_TOOL_POLICY_APPROVE": "<gitlab_tool_policy_approve>",
        "GITLAB_TOOL_POLICY_HIDDEN": "<gitlab_tool_policy_hidden>",
        "NODE_TLS_REJECT_UNAUTHORIZED": "<node_tls_reject_unauthorized>",
        "GITLAB_CA_CERT_PATH": "<gitlab_ca_cert_path>",
        "GITLAB_MASKING_ENABLED": "false",
        "GITLAB_MASKING_CONFIG": "<gitlab_masking_config>",
        "GITLAB_MASKING_POLICY_FILE": "<gitlab_masking_policy_file>",
        "GITLAB_MASKING_WORKSPACE_DIR": "<gitlab_masking_workspace_dir>"
      }
    }
  }
}

Cline (cline_mcp_settings.json)

{
  "mcpServers": {
    "gitlab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "--",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<your-gitlab_personal_access_token>",
        "GITLAB_PERSONAL_ACCESS_TOKEN_FILE": "<gitlab_personal_access_token_file>",
        "GITLAB_JOB_TOKEN": "<your-gitlab_job_token>",
        "GITLAB_AUTH_COOKIE_PATH": "<gitlab_auth_cookie_path>",
        "GITLAB_USE_OAUTH": "<gitlab_use_oauth>",
        "GITLAB_OAUTH_CLIENT_ID": "<gitlab_oauth_client_id>",
        "GITLAB_OAUTH_TOKEN_SCRIPT": "<gitlab_oauth_token_script>",
        "GITLAB_API_URL": "https://gitlab.com/api/v4",
        "GITLAB_ALLOWED_PROJECT_IDS": "<gitlab_allowed_project_ids>",
        "GITLAB_PERMISSION_MODE": "<gitlab_permission_mode>",
        "GITLAB_TOOLSETS": "<gitlab_toolsets>",
        "GITLAB_TOOLS": "<gitlab_tools>",
        "GITLAB_DENIED_TOOLS_REGEX": "<gitlab_denied_tools_regex>",
        "GITLAB_TOOL_POLICY_APPROVE": "<gitlab_tool_policy_approve>",
        "GITLAB_TOOL_POLICY_HIDDEN": "<gitlab_tool_policy_hidden>",
        "NODE_TLS_REJECT_UNAUTHORIZED": "<node_tls_reject_unauthorized>",
        "GITLAB_CA_CERT_PATH": "<gitlab_ca_cert_path>",
        "GITLAB_MASKING_ENABLED": "false",
        "GITLAB_MASKING_CONFIG": "<gitlab_masking_config>",
        "GITLAB_MASKING_POLICY_FILE": "<gitlab_masking_policy_file>",
        "GITLAB_MASKING_WORKSPACE_DIR": "<gitlab_masking_workspace_dir>"
      }
    }
  }
}

Zed (~/.config/zed/settings.json)

Merge into the context_servers block of your Zed settings.

{
  "context_servers": {
    "gitlab-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "--",
        "@zereight/mcp-gitlab"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<your-gitlab_personal_access_token>",
        "GITLAB_PERSONAL_ACCESS_TOKEN_FILE": "<gitlab_personal_access_token_file>",
        "GITLAB_JOB_TOKEN": "<your-gitlab_job_token>",
        "GITLAB_AUTH_COOKIE_PATH": "<gitlab_auth_cookie_path>",
        "GITLAB_USE_OAUTH": "<gitlab_use_oauth>",
        "GITLAB_OAUTH_CLIENT_ID": "<gitlab_oauth_client_id>",
        "GITLAB_OAUTH_TOKEN_SCRIPT": "<gitlab_oauth_token_script>",
        "GITLAB_API_URL": "https://gitlab.com/api/v4",
        "GITLAB_ALLOWED_PROJECT_IDS": "<gitlab_allowed_project_ids>",
        "GITLAB_PERMISSION_MODE": "<gitlab_permission_mode>",
        "GITLAB_TOOLSETS": "<gitlab_toolsets>",
        "GITLAB_TOOLS": "<gitlab_tools>",
        "GITLAB_DENIED_TOOLS_REGEX": "<gitlab_denied_tools_regex>",
        "GITLAB_TOOL_POLICY_APPROVE": "<gitlab_tool_policy_approve>",
        "GITLAB_TOOL_POLICY_HIDDEN": "<gitlab_tool_policy_hidden>",
        "NODE_TLS_REJECT_UNAUTHORIZED": "<node_tls_reject_unauthorized>",
        "GITLAB_CA_CERT_PATH": "<gitlab_ca_cert_path>",
        "GITLAB_MASKING_ENABLED": "false",
        "GITLAB_MASKING_CONFIG": "<gitlab_masking_config>",
        "GITLAB_MASKING_POLICY_FILE": "<gitlab_masking_policy_file>",
        "GITLAB_MASKING_WORKSPACE_DIR": "<gitlab_masking_workspace_dir>"
      }
    }
  }
}

Claude Code (claude mcp add)

claude mcp add --scope user gitlab-mcp -- npx -y -- @zereight/mcp-gitlab

Gemini CLI (gemini mcp add)

gemini mcp add -s user gitlab-mcp npx -y -- @zereight/mcp-gitlab

Claude Desktop (Docker)

{
  "mcpServers": {
    "gitlab-mcp": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "--",
        "docker.io/zereight050/gitlab-mcp:2.3.15"
      ],
      "env": {
        "GITLAB_PERSONAL_ACCESS_TOKEN": "<your-gitlab_personal_access_token>",
        "GITLAB_PERSONAL_ACCESS_TOKEN_FILE": "<gitlab_personal_access_token_file>",
        "GITLAB_JOB_TOKEN": "<your-gitlab_job_token>",
        "GITLAB_AUTH_COOKIE_PATH": "<gitlab_auth_cookie_path>",
        "GITLAB_USE_OAUTH": "<gitlab_use_oauth>",
        "GITLAB_OAUTH_CLIENT_ID": "<gitlab_oauth_client_id>",
        "GITLAB_OAUTH_TOKEN_SCRIPT": "<gitlab_oauth_token_script>",
        "GITLAB_API_URL": "https://gitlab.com/api/v4",
        "GITLAB_ALLOWED_PROJECT_IDS": "<gitlab_allowed_project_ids>",
        "GITLAB_PERMISSION_MODE": "<gitlab_permission_mode>",
        "GITLAB_TOOLSETS": "<gitlab_toolsets>",
        "GITLAB_TOOLS": "<gitlab_tools>",
        "GITLAB_DENIED_TOOLS_REGEX": "<gitlab_denied_tools_regex>",
        "GITLAB_TOOL_POLICY_APPROVE": "<gitlab_tool_policy_approve>",
        "GITLAB_TOOL_POLICY_HIDDEN": "<gitlab_tool_policy_hidden>",
        "NODE_TLS_REJECT_UNAUTHORIZED": "<node_tls_reject_unauthorized>",
        "GITLAB_CA_CERT_PATH": "<gitlab_ca_cert_path>",
        "GITLAB_MASKING_ENABLED": "false",
        "GITLAB_MASKING_CONFIG": "<gitlab_masking_config>",
        "GITLAB_MASKING_POLICY_FILE": "<gitlab_masking_policy_file>",
        "GITLAB_MASKING_WORKSPACE_DIR": "<gitlab_masking_workspace_dir>"
      }
    }
  }
}

Verdict API

curl -s mcpindex.ai/api/v1/trust/server/io-github-zereight-gitlab-mcp

Free-tier verdict as JSON: decision + dimensions + severity. Call it from your agent before it invokes a tool it just discovered.

Details

version: v2.3.15
category: Git & Code Hosting
verdict expires: 2026-11-05
quality: 100 / 100
operator: zereight

Listing

Listed from the official MCP registry. Unclaimed by its maintainer. Maintainer? Email us →

Provenance

Each verdict is bound to a hash of the exact description it judged, so a re-crawl that changes the text produces a new record rather than silently inheriting this one. Verdict history is hash-chained and anchored to Bitcoin via OpenTimestamps (latest confirmed at block 973,647). Verify it yourself.

Links

Repository →Website →