io.github.jmrplens/gitlab-mcp-server icon
io.github.jmrplens

gitlab-mcp-server

GitLab MCP Server

Manage GitLab projects, issues, merge requests, pipelines, repositories, and admin workflows.

Hosted
communityservice

Deployment

Hosted
streamable-httphttps://gitlab-mcp-server.fly.dev/
Headers
PRIVATE-TOKENRequired
GitLab Personal Access Token (glpat-...). Alternatively, send Authorization: Bearer <token>.
GITLAB-URLRequired
Target GitLab instance URL (e.g. https://gitlab.com). Required in the public hosted multi-tenant instance.
streamable-httphttps://{host}:{port}/
Headers
PRIVATE-TOKENRequired
GitLab Personal Access Token (glpat-...). Alternatively, send Authorization: Bearer <token>.
GITLAB-URL
Target GitLab instance URL. Omit if the server was started with --gitlab-url.

Package Details

Transportstdio
File SHA2565c1ef617ba604a034f83d1e3fa7cde2698b87953cb959f306378516bfd280bbb

Environment Variables

GITLAB_URL
Default:https://gitlab.com

GitLab instance URL (default: https://gitlab.com; set for self-managed instances)

GITLAB_TOKEN
RequiredSecret

GitLab Personal Access Token (glpat-...)

GITLAB_SKIP_TLS_VERIFY(bool)
Default:false

Skip TLS certificate verification for self-signed certs (default: false)

TOOL_SURFACE
Default:dynamic

Tool catalog selector: dynamic, meta, or individual (default: dynamic)

CAPABILITY_SURFACE
Default:full

Resource and prompt catalog selector: full or minimal (default: full)

META_PARAM_SCHEMA
Default:opaque

Meta-tool input schema detail: opaque, compact, or full (default: opaque)

GITLAB_ENTERPRISE(bool)
Default:false

Enable GitLab Premium/Ultimate tools; GitLab.com Enterprise/Premium also exposes Orbit Knowledge Graph tools (default: false)

GITLAB_READ_ONLY(bool)
Default:false

Read-only mode: disables all mutating tools (default: false)

GITLAB_SAFE_MODE(bool)
Default:false

Safe mode: intercepts mutating tools and returns a JSON preview instead of executing (default: false)

EMBEDDED_RESOURCES(bool)
Default:true

Append EmbeddedResource content blocks (clickable links to MCP resources) to get_* tool results (default: true)

EXCLUDE_TOOLS

Comma-separated tool names to exclude from registration (e.g. gitlab_admin,gitlab_runner)

GITLAB_IGNORE_SCOPES(bool)
Default:false

Skip Personal Access Token scope detection and register all tools regardless of token permissions (default: false)

UPLOAD_MAX_FILE_SIZE
Default:2147483648

Maximum attachment upload size in bytes or human-readable (e.g. 2GB). Default: 2147483648 (2 GB)

GITLAB_MCP_ALLOWED_IMPORT_DIRS

Extra OS path-list-separated directories allowed for local GitLab import archives

RATE_LIMIT_RPS(num)
Default:0

Per-server tools/call rate limit in requests per second; 0 disables it (default: 0)

RATE_LIMIT_BURST(num)
Default:40

Token-bucket burst size when RATE_LIMIT_RPS is greater than 0 (default: 40)

LOG_LEVEL
Default:info

Logging verbosity (default: info)

AUTO_UPDATE
Default:true

Auto-update mode: true (auto-apply), check (log-only), false (disabled). Default: true

AUTO_UPDATE_REPO
Default:jmrplens/gitlab-mcp-server

GitHub repository slug for release assets (default: jmrplens/gitlab-mcp-server)

AUTO_UPDATE_INTERVAL
Default:1h

Periodic update check interval in HTTP mode (default: 1h)

AUTO_UPDATE_TIMEOUT
Default:60s

Startup/background update timeout, range 5s-10m (default: 60s)

Transportstdio
File SHA256f1261d24b2f1b40fc0565f0f9301c1ac7e613c7b107249d4743da869d424158b

Environment Variables

GITLAB_URL
Default:https://gitlab.com

GitLab instance URL (default: https://gitlab.com; set for self-managed instances)

GITLAB_TOKEN
RequiredSecret

GitLab Personal Access Token (glpat-...)

GITLAB_SKIP_TLS_VERIFY(bool)
Default:false

Skip TLS certificate verification for self-signed certs (default: false)

TOOL_SURFACE
Default:dynamic

Tool catalog selector: dynamic, meta, or individual (default: dynamic)

CAPABILITY_SURFACE
Default:full

Resource and prompt catalog selector: full or minimal (default: full)

META_PARAM_SCHEMA
Default:opaque

Meta-tool input schema detail: opaque, compact, or full (default: opaque)

GITLAB_ENTERPRISE(bool)
Default:false

Enable GitLab Premium/Ultimate tools; GitLab.com Enterprise/Premium also exposes Orbit Knowledge Graph tools (default: false)

GITLAB_READ_ONLY(bool)
Default:false

Read-only mode: disables all mutating tools (default: false)

GITLAB_SAFE_MODE(bool)
Default:false

Safe mode: intercepts mutating tools and returns a JSON preview instead of executing (default: false)

EMBEDDED_RESOURCES(bool)
Default:true

Append EmbeddedResource content blocks (clickable links to MCP resources) to get_* tool results (default: true)

EXCLUDE_TOOLS

Comma-separated tool names to exclude from registration (e.g. gitlab_admin,gitlab_runner)

GITLAB_IGNORE_SCOPES(bool)
Default:false

Skip Personal Access Token scope detection and register all tools regardless of token permissions (default: false)

UPLOAD_MAX_FILE_SIZE
Default:2147483648

Maximum attachment upload size in bytes or human-readable (e.g. 2GB). Default: 2147483648 (2 GB)

GITLAB_MCP_ALLOWED_IMPORT_DIRS

Extra OS path-list-separated directories allowed for local GitLab import archives

RATE_LIMIT_RPS(num)
Default:0

Per-server tools/call rate limit in requests per second; 0 disables it (default: 0)

RATE_LIMIT_BURST(num)
Default:40

Token-bucket burst size when RATE_LIMIT_RPS is greater than 0 (default: 40)

LOG_LEVEL
Default:info

Logging verbosity (default: info)

AUTO_UPDATE
Default:true

Auto-update mode: true (auto-apply), check (log-only), false (disabled). Default: true

AUTO_UPDATE_REPO
Default:jmrplens/gitlab-mcp-server

GitHub repository slug for release assets (default: jmrplens/gitlab-mcp-server)

AUTO_UPDATE_INTERVAL
Default:1h

Periodic update check interval in HTTP mode (default: 1h)

AUTO_UPDATE_TIMEOUT
Default:60s

Startup/background update timeout, range 5s-10m (default: 60s)

Transportstdio
File SHA25688a5cfcf78f54580689a6e577ebe1eff3bc65a5f2420e78ca950c14014164013

Environment Variables

GITLAB_URL
Default:https://gitlab.com

GitLab instance URL (default: https://gitlab.com; set for self-managed instances)

GITLAB_TOKEN
RequiredSecret

GitLab Personal Access Token (glpat-...)

GITLAB_SKIP_TLS_VERIFY(bool)
Default:false

Skip TLS certificate verification for self-signed certs (default: false)

TOOL_SURFACE
Default:dynamic

Tool catalog selector: dynamic, meta, or individual (default: dynamic)

CAPABILITY_SURFACE
Default:full

Resource and prompt catalog selector: full or minimal (default: full)

META_PARAM_SCHEMA
Default:opaque

Meta-tool input schema detail: opaque, compact, or full (default: opaque)

GITLAB_ENTERPRISE(bool)
Default:false

Enable GitLab Premium/Ultimate tools; GitLab.com Enterprise/Premium also exposes Orbit Knowledge Graph tools (default: false)

GITLAB_READ_ONLY(bool)
Default:false

Read-only mode: disables all mutating tools (default: false)

GITLAB_SAFE_MODE(bool)
Default:false

Safe mode: intercepts mutating tools and returns a JSON preview instead of executing (default: false)

EMBEDDED_RESOURCES(bool)
Default:true

Append EmbeddedResource content blocks (clickable links to MCP resources) to get_* tool results (default: true)

EXCLUDE_TOOLS

Comma-separated tool names to exclude from registration (e.g. gitlab_admin,gitlab_runner)

GITLAB_IGNORE_SCOPES(bool)
Default:false

Skip Personal Access Token scope detection and register all tools regardless of token permissions (default: false)

UPLOAD_MAX_FILE_SIZE
Default:2147483648

Maximum attachment upload size in bytes or human-readable (e.g. 2GB). Default: 2147483648 (2 GB)

GITLAB_MCP_ALLOWED_IMPORT_DIRS

Extra OS path-list-separated directories allowed for local GitLab import archives

RATE_LIMIT_RPS(num)
Default:0

Per-server tools/call rate limit in requests per second; 0 disables it (default: 0)

RATE_LIMIT_BURST(num)
Default:40

Token-bucket burst size when RATE_LIMIT_RPS is greater than 0 (default: 40)

LOG_LEVEL
Default:info

Logging verbosity (default: info)

AUTO_UPDATE
Default:true

Auto-update mode: true (auto-apply), check (log-only), false (disabled). Default: true

AUTO_UPDATE_REPO
Default:jmrplens/gitlab-mcp-server

GitHub repository slug for release assets (default: jmrplens/gitlab-mcp-server)

AUTO_UPDATE_INTERVAL
Default:1h

Periodic update check interval in HTTP mode (default: 1h)

AUTO_UPDATE_TIMEOUT
Default:60s

Startup/background update timeout, range 5s-10m (default: 60s)

Transportstdio
File SHA256aa8ac7518e04f9447886632c28210a18c8ef5339908bbeca9799add2302efe14

Environment Variables

GITLAB_URL
Default:https://gitlab.com

GitLab instance URL (default: https://gitlab.com; set for self-managed instances)

GITLAB_TOKEN
RequiredSecret

GitLab Personal Access Token (glpat-...)

GITLAB_SKIP_TLS_VERIFY(bool)
Default:false

Skip TLS certificate verification for self-signed certs (default: false)

TOOL_SURFACE
Default:dynamic

Tool catalog selector: dynamic, meta, or individual (default: dynamic)

CAPABILITY_SURFACE
Default:full

Resource and prompt catalog selector: full or minimal (default: full)

META_PARAM_SCHEMA
Default:opaque

Meta-tool input schema detail: opaque, compact, or full (default: opaque)

GITLAB_ENTERPRISE(bool)
Default:false

Enable GitLab Premium/Ultimate tools; GitLab.com Enterprise/Premium also exposes Orbit Knowledge Graph tools (default: false)

GITLAB_READ_ONLY(bool)
Default:false

Read-only mode: disables all mutating tools (default: false)

GITLAB_SAFE_MODE(bool)
Default:false

Safe mode: intercepts mutating tools and returns a JSON preview instead of executing (default: false)

EMBEDDED_RESOURCES(bool)
Default:true

Append EmbeddedResource content blocks (clickable links to MCP resources) to get_* tool results (default: true)

EXCLUDE_TOOLS

Comma-separated tool names to exclude from registration (e.g. gitlab_admin,gitlab_runner)

GITLAB_IGNORE_SCOPES(bool)
Default:false

Skip Personal Access Token scope detection and register all tools regardless of token permissions (default: false)

UPLOAD_MAX_FILE_SIZE
Default:2147483648

Maximum attachment upload size in bytes or human-readable (e.g. 2GB). Default: 2147483648 (2 GB)

GITLAB_MCP_ALLOWED_IMPORT_DIRS

Extra OS path-list-separated directories allowed for local GitLab import archives

RATE_LIMIT_RPS(num)
Default:0

Per-server tools/call rate limit in requests per second; 0 disables it (default: 0)

RATE_LIMIT_BURST(num)
Default:40

Token-bucket burst size when RATE_LIMIT_RPS is greater than 0 (default: 40)

LOG_LEVEL
Default:info

Logging verbosity (default: info)

AUTO_UPDATE
Default:true

Auto-update mode: true (auto-apply), check (log-only), false (disabled). Default: true

AUTO_UPDATE_REPO
Default:jmrplens/gitlab-mcp-server

GitHub repository slug for release assets (default: jmrplens/gitlab-mcp-server)

AUTO_UPDATE_INTERVAL
Default:1h

Periodic update check interval in HTTP mode (default: 1h)

AUTO_UPDATE_TIMEOUT
Default:60s

Startup/background update timeout, range 5s-10m (default: 60s)

Transportstdio
File SHA256c092833d4e74fe9bdb414e5905293fe7a0e4e8df94e19b591ba26f44df1a3c4a

Environment Variables

GITLAB_URL
Default:https://gitlab.com

GitLab instance URL (default: https://gitlab.com; set for self-managed instances)

GITLAB_TOKEN
RequiredSecret

GitLab Personal Access Token (glpat-...)

GITLAB_SKIP_TLS_VERIFY(bool)
Default:false

Skip TLS certificate verification for self-signed certs (default: false)

TOOL_SURFACE
Default:dynamic

Tool catalog selector: dynamic, meta, or individual (default: dynamic)

CAPABILITY_SURFACE
Default:full

Resource and prompt catalog selector: full or minimal (default: full)

META_PARAM_SCHEMA
Default:opaque

Meta-tool input schema detail: opaque, compact, or full (default: opaque)

GITLAB_ENTERPRISE(bool)
Default:false

Enable GitLab Premium/Ultimate tools; GitLab.com Enterprise/Premium also exposes Orbit Knowledge Graph tools (default: false)

GITLAB_READ_ONLY(bool)
Default:false

Read-only mode: disables all mutating tools (default: false)

GITLAB_SAFE_MODE(bool)
Default:false

Safe mode: intercepts mutating tools and returns a JSON preview instead of executing (default: false)

EMBEDDED_RESOURCES(bool)
Default:true

Append EmbeddedResource content blocks (clickable links to MCP resources) to get_* tool results (default: true)

EXCLUDE_TOOLS

Comma-separated tool names to exclude from registration (e.g. gitlab_admin,gitlab_runner)

GITLAB_IGNORE_SCOPES(bool)
Default:false

Skip Personal Access Token scope detection and register all tools regardless of token permissions (default: false)

UPLOAD_MAX_FILE_SIZE
Default:2147483648

Maximum attachment upload size in bytes or human-readable (e.g. 2GB). Default: 2147483648 (2 GB)

GITLAB_MCP_ALLOWED_IMPORT_DIRS

Extra OS path-list-separated directories allowed for local GitLab import archives

RATE_LIMIT_RPS(num)
Default:0

Per-server tools/call rate limit in requests per second; 0 disables it (default: 0)

RATE_LIMIT_BURST(num)
Default:40

Token-bucket burst size when RATE_LIMIT_RPS is greater than 0 (default: 40)

LOG_LEVEL
Default:info

Logging verbosity (default: info)

AUTO_UPDATE
Default:true

Auto-update mode: true (auto-apply), check (log-only), false (disabled). Default: true

AUTO_UPDATE_REPO
Default:jmrplens/gitlab-mcp-server

GitHub repository slug for release assets (default: jmrplens/gitlab-mcp-server)

AUTO_UPDATE_INTERVAL
Default:1h

Periodic update check interval in HTTP mode (default: 1h)

AUTO_UPDATE_TIMEOUT
Default:60s

Startup/background update timeout, range 5s-10m (default: 60s)

Transportstdio
File SHA256dc5423b4a48fb0cf3923912626dbbffd228004829800f39c5ba9e93317de47e2

Environment Variables

GITLAB_URL
Default:https://gitlab.com

GitLab instance URL (default: https://gitlab.com; set for self-managed instances)

GITLAB_TOKEN
RequiredSecret

GitLab Personal Access Token (glpat-...)

GITLAB_SKIP_TLS_VERIFY(bool)
Default:false

Skip TLS certificate verification for self-signed certs (default: false)

TOOL_SURFACE
Default:dynamic

Tool catalog selector: dynamic, meta, or individual (default: dynamic)

CAPABILITY_SURFACE
Default:full

Resource and prompt catalog selector: full or minimal (default: full)

META_PARAM_SCHEMA
Default:opaque

Meta-tool input schema detail: opaque, compact, or full (default: opaque)

GITLAB_ENTERPRISE(bool)
Default:false

Enable GitLab Premium/Ultimate tools; GitLab.com Enterprise/Premium also exposes Orbit Knowledge Graph tools (default: false)

GITLAB_READ_ONLY(bool)
Default:false

Read-only mode: disables all mutating tools (default: false)

GITLAB_SAFE_MODE(bool)
Default:false

Safe mode: intercepts mutating tools and returns a JSON preview instead of executing (default: false)

EMBEDDED_RESOURCES(bool)
Default:true

Append EmbeddedResource content blocks (clickable links to MCP resources) to get_* tool results (default: true)

EXCLUDE_TOOLS

Comma-separated tool names to exclude from registration (e.g. gitlab_admin,gitlab_runner)

GITLAB_IGNORE_SCOPES(bool)
Default:false

Skip Personal Access Token scope detection and register all tools regardless of token permissions (default: false)

UPLOAD_MAX_FILE_SIZE
Default:2147483648

Maximum attachment upload size in bytes or human-readable (e.g. 2GB). Default: 2147483648 (2 GB)

GITLAB_MCP_ALLOWED_IMPORT_DIRS

Extra OS path-list-separated directories allowed for local GitLab import archives

RATE_LIMIT_RPS(num)
Default:0

Per-server tools/call rate limit in requests per second; 0 disables it (default: 0)

RATE_LIMIT_BURST(num)
Default:40

Token-bucket burst size when RATE_LIMIT_RPS is greater than 0 (default: 40)

LOG_LEVEL
Default:info

Logging verbosity (default: info)

AUTO_UPDATE
Default:true

Auto-update mode: true (auto-apply), check (log-only), false (disabled). Default: true

AUTO_UPDATE_REPO
Default:jmrplens/gitlab-mcp-server

GitHub repository slug for release assets (default: jmrplens/gitlab-mcp-server)

AUTO_UPDATE_INTERVAL
Default:1h

Periodic update check interval in HTTP mode (default: 1h)

AUTO_UPDATE_TIMEOUT
Default:60s

Startup/background update timeout, range 5s-10m (default: 60s)