GitLab MCP Server

GitLab MCP Server is a remote MCP server: there is nothing to install. Its endpoint is https://mcp.jmrp.io/gitlab, served over Streamable HTTP. In an assistant that accepts remote MCP servers (often under a setting named connectors, integrations or tools), add a new server and give it this URL; in a client configured by file, add it as a remote (HTTP) server with the same URL.

The registry entry declares an HTTP header for the connection: Authorization (secret). A secret header usually carries an API key or token issued by the service; clients that accept custom headers set it with the server's URL.

It can also run locally from an MCP Bundle: a single downloadable archive holding a local server and a manifest that describes it: https://github.com/jmrplens/gitlab-mcp-server/releases/download/v3.1.0/gitlab-mcp-server.mcpb version 3.1.0. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs a client that installs MCP Bundles; the file is opened in, or added to, that client. It reads these environment variables: GITLAB_URL, GITLAB_TOKEN (required, secret), GITLAB_MCP_SKIP_TLS_VERIFY, GITLAB_MCP_TOOL_SURFACE, GITLAB_MCP_CAPABILITY_SURFACE, GITLAB_MCP_META_PARAM_SCHEMA, GITLAB_MCP_TIER, GITLAB_MCP_READ_ONLY, GITLAB_MCP_SAFE_MODE, GITLAB_MCP_EMBEDDED_RESOURCES, GITLAB_MCP_EXCLUDE_TOOLS, GITLAB_MCP_IGNORE_SCOPES, GITLAB_MCP_UPLOAD_MAX_FILE_SIZE, GITLAB_MCP_ALLOWED_IMPORT_DIRS, GITLAB_MCP_RATE_LIMIT_RPS, GITLAB_MCP_RATE_LIMIT_BURST and GITLAB_MCP_LOG_LEVEL; set them in the client's configuration for this server.

It can also run locally from a container image in an OCI registry such as Docker Hub or GitHub Container Registry: ghcr.io/jmrplens/gitlab-mcp-server:3.1.0@sha256:87e483299a2663a7a5d4d28679859b0c7fba2b1a421b7de2652441a569d4a2fc. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs Docker or another OCI container runtime; started with docker run — the usual command is docker run -i --rm -e GITLAB_URL -e GITLAB_TOKEN -e GITLAB_MCP_SKIP_TLS_VERIFY -e GITLAB_MCP_TOOL_SURFACE -e GITLAB_MCP_CAPABILITY_SURFACE -e GITLAB_MCP_META_PARAM_SCHEMA -e GITLAB_MCP_TIER -e GITLAB_MCP_READ_ONLY -e GITLAB_MCP_SAFE_MODE -e GITLAB_MCP_EMBEDDED_RESOURCES -e GITLAB_MCP_EXCLUDE_TOOLS -e GITLAB_MCP_IGNORE_SCOPES -e GITLAB_MCP_UPLOAD_MAX_FILE_SIZE -e GITLAB_MCP_ALLOWED_IMPORT_DIRS -e GITLAB_MCP_RATE_LIMIT_RPS -e GITLAB_MCP_RATE_LIMIT_BURST -e GITLAB_MCP_LOG_LEVEL ghcr.io/jmrplens/gitlab-mcp-server:3.1.0@sha256:87e483299a2663a7a5d4d28679859b0c7fba2b1a421b7de2652441a569d4a2fc. It reads these environment variables: GITLAB_URL, GITLAB_TOKEN (required, secret), GITLAB_MCP_SKIP_TLS_VERIFY, GITLAB_MCP_TOOL_SURFACE, GITLAB_MCP_CAPABILITY_SURFACE, GITLAB_MCP_META_PARAM_SCHEMA, GITLAB_MCP_TIER, GITLAB_MCP_READ_ONLY, GITLAB_MCP_SAFE_MODE, GITLAB_MCP_EMBEDDED_RESOURCES, GITLAB_MCP_EXCLUDE_TOOLS, GITLAB_MCP_IGNORE_SCOPES, GITLAB_MCP_UPLOAD_MAX_FILE_SIZE, GITLAB_MCP_ALLOWED_IMPORT_DIRS, GITLAB_MCP_RATE_LIMIT_RPS, GITLAB_MCP_RATE_LIMIT_BURST and GITLAB_MCP_LOG_LEVEL; set them in the client's configuration for this server.

It can also run locally from a container image in an OCI registry such as Docker Hub or GitHub Container Registry: docker.io/jmrplens/gitlab-mcp-server:3.1.0@sha256:87e483299a2663a7a5d4d28679859b0c7fba2b1a421b7de2652441a569d4a2fc. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs Docker or another OCI container runtime; started with docker run — the usual command is docker run -i --rm -e GITLAB_URL -e GITLAB_TOKEN -e GITLAB_MCP_SKIP_TLS_VERIFY -e GITLAB_MCP_TOOL_SURFACE -e GITLAB_MCP_CAPABILITY_SURFACE -e GITLAB_MCP_META_PARAM_SCHEMA -e GITLAB_MCP_TIER -e GITLAB_MCP_READ_ONLY -e GITLAB_MCP_SAFE_MODE -e GITLAB_MCP_EMBEDDED_RESOURCES -e GITLAB_MCP_EXCLUDE_TOOLS -e GITLAB_MCP_IGNORE_SCOPES -e GITLAB_MCP_UPLOAD_MAX_FILE_SIZE -e GITLAB_MCP_ALLOWED_IMPORT_DIRS -e GITLAB_MCP_RATE_LIMIT_RPS -e GITLAB_MCP_RATE_LIMIT_BURST -e GITLAB_MCP_LOG_LEVEL docker.io/jmrplens/gitlab-mcp-server:3.1.0@sha256:87e483299a2663a7a5d4d28679859b0c7fba2b1a421b7de2652441a569d4a2fc. It reads these environment variables: GITLAB_URL, GITLAB_TOKEN (required, secret), GITLAB_MCP_SKIP_TLS_VERIFY, GITLAB_MCP_TOOL_SURFACE, GITLAB_MCP_CAPABILITY_SURFACE, GITLAB_MCP_META_PARAM_SCHEMA, GITLAB_MCP_TIER, GITLAB_MCP_READ_ONLY, GITLAB_MCP_SAFE_MODE, GITLAB_MCP_EMBEDDED_RESOURCES, GITLAB_MCP_EXCLUDE_TOOLS, GITLAB_MCP_IGNORE_SCOPES, GITLAB_MCP_UPLOAD_MAX_FILE_SIZE, GITLAB_MCP_ALLOWED_IMPORT_DIRS, GITLAB_MCP_RATE_LIMIT_RPS, GITLAB_MCP_RATE_LIMIT_BURST and GITLAB_MCP_LOG_LEVEL; set them in the client's configuration for this server.

It can also run locally from a Node.js package published to the npm registry: @jmrp.io/gitlab-mcp-server version 3.1.0. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs Node.js; clients usually start it with npx — the usual command is npx -y @jmrp.io/gitlab-mcp-server@3.1.0. It reads these environment variables: GITLAB_URL, GITLAB_TOKEN (required, secret), GITLAB_MCP_SKIP_TLS_VERIFY, GITLAB_MCP_TOOL_SURFACE, GITLAB_MCP_CAPABILITY_SURFACE, GITLAB_MCP_META_PARAM_SCHEMA, GITLAB_MCP_TIER, GITLAB_MCP_READ_ONLY, GITLAB_MCP_SAFE_MODE, GITLAB_MCP_EMBEDDED_RESOURCES, GITLAB_MCP_EXCLUDE_TOOLS, GITLAB_MCP_IGNORE_SCOPES, GITLAB_MCP_UPLOAD_MAX_FILE_SIZE, GITLAB_MCP_ALLOWED_IMPORT_DIRS, GITLAB_MCP_RATE_LIMIT_RPS, GITLAB_MCP_RATE_LIMIT_BURST and GITLAB_MCP_LOG_LEVEL; set them in the client's configuration for this server.

It can also run locally from a Python package published to PyPI: jmrplens-gitlab-mcp-server version 3.1.0. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs Python; clients usually start it with uvx (from uv) or after pip install — the usual command is uvx jmrplens-gitlab-mcp-server. It reads these environment variables: GITLAB_URL, GITLAB_TOKEN (required, secret), GITLAB_MCP_SKIP_TLS_VERIFY, GITLAB_MCP_TOOL_SURFACE, GITLAB_MCP_CAPABILITY_SURFACE, GITLAB_MCP_META_PARAM_SCHEMA, GITLAB_MCP_TIER, GITLAB_MCP_READ_ONLY, GITLAB_MCP_SAFE_MODE, GITLAB_MCP_EMBEDDED_RESOURCES, GITLAB_MCP_EXCLUDE_TOOLS, GITLAB_MCP_IGNORE_SCOPES, GITLAB_MCP_UPLOAD_MAX_FILE_SIZE, GITLAB_MCP_ALLOWED_IMPORT_DIRS, GITLAB_MCP_RATE_LIMIT_RPS, GITLAB_MCP_RATE_LIMIT_BURST and GITLAB_MCP_LOG_LEVEL; set them in the client's configuration for this server.

It can also run locally from a .NET package published to NuGet: gitlab-mcp-server version 3.1.0. It speaks MCP over stdio, so the client starts it as a program and talks to it through standard input and output. It needs the .NET SDK; run as a .NET tool; the entry names dnx as the runtime. It reads these environment variables: GITLAB_URL, GITLAB_TOKEN (required, secret), GITLAB_MCP_SKIP_TLS_VERIFY, GITLAB_MCP_TOOL_SURFACE, GITLAB_MCP_CAPABILITY_SURFACE, GITLAB_MCP_META_PARAM_SCHEMA, GITLAB_MCP_TIER, GITLAB_MCP_READ_ONLY, GITLAB_MCP_SAFE_MODE, GITLAB_MCP_EMBEDDED_RESOURCES, GITLAB_MCP_EXCLUDE_TOOLS, GITLAB_MCP_IGNORE_SCOPES, GITLAB_MCP_UPLOAD_MAX_FILE_SIZE, GITLAB_MCP_ALLOWED_IMPORT_DIRS, GITLAB_MCP_RATE_LIMIT_RPS, GITLAB_MCP_RATE_LIMIT_BURST and GITLAB_MCP_LOG_LEVEL; set them in the client's configuration for this server.

In the mcpServers JSON format that many desktop and editor MCP clients read, the entry looks like this (placeholders in angle brackets):

{
  "mcpServers": {
    "gitlab-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "GITLAB_URL",
        "-e",
        "GITLAB_TOKEN",
        "-e",
        "GITLAB_MCP_SKIP_TLS_VERIFY",
        "-e",
        "GITLAB_MCP_TOOL_SURFACE",
        "-e",
        "GITLAB_MCP_CAPABILITY_SURFACE",
        "-e",
        "GITLAB_MCP_META_PARAM_SCHEMA",
        "-e",
        "GITLAB_MCP_TIER",
        "-e",
        "GITLAB_MCP_READ_ONLY",
        "-e",
        "GITLAB_MCP_SAFE_MODE",
        "-e",
        "GITLAB_MCP_EMBEDDED_RESOURCES",
        "-e",
        "GITLAB_MCP_EXCLUDE_TOOLS",
        "-e",
        "GITLAB_MCP_IGNORE_SCOPES",
        "-e",
        "GITLAB_MCP_UPLOAD_MAX_FILE_SIZE",
        "-e",
        "GITLAB_MCP_ALLOWED_IMPORT_DIRS",
        "-e",
        "GITLAB_MCP_RATE_LIMIT_RPS",
        "-e",
        "GITLAB_MCP_RATE_LIMIT_BURST",
        "-e",
        "GITLAB_MCP_LOG_LEVEL",
        "ghcr.io/jmrplens/gitlab-mcp-server:3.1.0@sha256:87e483299a2663a7a5d4d28679859b0c7fba2b1a421b7de2652441a569d4a2fc"
      ],
      "env": {
        "GITLAB_URL": "<value>",
        "GITLAB_TOKEN": "<secret>",
        "GITLAB_MCP_SKIP_TLS_VERIFY": "<value>",
        "GITLAB_MCP_TOOL_SURFACE": "<value>",
        "GITLAB_MCP_CAPABILITY_SURFACE": "<value>",
        "GITLAB_MCP_META_PARAM_SCHEMA": "<value>",
        "GITLAB_MCP_TIER": "<value>",
        "GITLAB_MCP_READ_ONLY": "<value>",
        "GITLAB_MCP_SAFE_MODE": "<value>",
        "GITLAB_MCP_EMBEDDED_RESOURCES": "<value>",
        "GITLAB_MCP_EXCLUDE_TOOLS": "<value>",
        "GITLAB_MCP_IGNORE_SCOPES": "<value>",
        "GITLAB_MCP_UPLOAD_MAX_FILE_SIZE": "<value>",
        "GITLAB_MCP_ALLOWED_IMPORT_DIRS": "<value>",
        "GITLAB_MCP_RATE_LIMIT_RPS": "<value>",
        "GITLAB_MCP_RATE_LIMIT_BURST": "<value>",
        "GITLAB_MCP_LOG_LEVEL": "<value>"
      }
    }
  }
}

Derived from the registry entry, not tested here. What the server does, and on what terms, is set by its publisher; check its repository or website before giving it access to your accounts or files. How to add an MCP server to an assistant · Before you connect