mshegolev avatar

Gitlab Ci Mcp

mshegolev/gitlab-ci-mcp

Connects Claude or any MCP client to GitLab's CI/CD APIs, covering pipelines, jobs, schedules, branches, tags, merge requests, and repository files. Every tool returns structured output with pre-rendered markdown, uses Pydantic validation, and surfaces auth or rate-limit errors as actionable messages. The pipeline health tool gives you a 7-day pass/fail summary in one call. Includes log grepping to filter huge CI traces without dumping everything into context. Works with gitlab.com or self-hosted instances, handles corporate proxies via NO_PROXY injection, and reuses HTTP sessions per project to stay under rate limits. Built on FastMCP with stdio transport, so it runs as a local command via uvx.

tools
24
auth
Secret needed
transport
STDIO
env vars
4
last updated
Apr 17, 2026

Tools

24 tools

Public tool metadata for what this MCP can expose to an agent.

gitlab_list_pipelinesList pipelines for a project.

List pipelines for a project.

No parameter schema in public metadata yet.

gitlab_get_pipeline

No parameter schema in public metadata yet.

gitlab_get_pipeline_jobs

No parameter schema in public metadata yet.

gitlab_get_job_log

No parameter schema in public metadata yet.

gitlab_trigger_pipeline

No parameter schema in public metadata yet.

gitlab_retry_pipeline

No parameter schema in public metadata yet.

gitlab_cancel_pipeline

No parameter schema in public metadata yet.

gitlab_pipeline_healthReturns a ready-to-read pipeline success-rate summary over 7 and 30 days.

Returns a ready-to-read pipeline success-rate summary over 7 and 30 days.

No parameter schema in public metadata yet.

gitlab_list_schedules

No parameter schema in public metadata yet.

gitlab_create_schedule

No parameter schema in public metadata yet.

gitlab_update_schedule

No parameter schema in public metadata yet.

gitlab_delete_schedule

No parameter schema in public metadata yet.

gitlab_list_branches

No parameter schema in public metadata yet.

gitlab_list_tags

No parameter schema in public metadata yet.

gitlab_compare_branches

No parameter schema in public metadata yet.

gitlab_list_merge_requests

No parameter schema in public metadata yet.

gitlab_get_merge_request

No parameter schema in public metadata yet.

gitlab_get_merge_request_changes

No parameter schema in public metadata yet.

gitlab_create_merge_request

No parameter schema in public metadata yet.

gitlab_merge_mr

No parameter schema in public metadata yet.

gitlab_get_file

No parameter schema in public metadata yet.

gitlab_list_repository_tree

No parameter schema in public metadata yet.

gitlab_project_info

No parameter schema in public metadata yet.

gitlab_ci_mcp_check_updatesExplicit tool that checks PyPI for a newer package version when enabled.

Explicit tool that checks PyPI for a newer package version when enabled.

No parameter schema in public metadata yet.

Sponsors

Configuration

GITLAB_URL*

GitLab instance URL (e.g. https://gitlab.com or https://gitlab.example.com)

GITLAB_TOKEN*secret

GitLab Personal Access Token with 'api' scope

GITLAB_PROJECT_PATH

Default project path (e.g. my-org/my-repo); can be overridden per call

GITLAB_SSL_VERIFYdefault: true

Verify SSL certificates (true/false). Set to 'false' for self-hosted GitLab with self-signed certs.

Readme

gitlab-ci-mcp

PyPI Python License: MIT Downloads

MCP server for GitLab CI/CD. Lets an LLM agent (Claude Code, Cursor, OpenCode, DevX Agent, etc.) work with pipelines, jobs, schedules, branches, tags, merge requests and repository files.

Python and FastMCP. Local stdio remains the default; opt-in Streamable HTTP supports shared deployments with one GitLab PAT per caller.

Works with any GitLab — SaaS gitlab.com or self-hosted / on-prem. Designed with corporate networks in mind: configurable NO_PROXY handling, optional SSL-verify toggle, per-project scoping via env vars.

Design highlights


View the full README on GitHub

Details

Repository
github.com/mshegolev/gitlab-ci-mcp
Category
Developer Tools
Package
gitlab-ci-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

More from mshegolev

Related Developer Tools MCP servers

View all
1mshegolev avatarSonarqube Mcpmshegolev/sonarqube-mcpSonarQube MCP — projects, metrics, quality gate, issues, worst-metric ranking.0stars
2ryamgoh avatarTerminal sessions for agentsryamgoh/terminal-mcpReal terminal sessions for agents: run commands, stream output, type into programs, kill trees.0stars
3shree-git avatarSendItshree-git/sendit-agent-integrationsPublish and schedule social posts, upload media, and review analytics through OAuth.0stars
4unbearabledev avatarGitHub Actions Auditunbearabledev/github-actions-auditGitHub Actions workflow security audit - 21 checks: pinning, permissions, secrets, injection.0stars
5idosal avatarGitMCPidosal/git-mcpProvides up-to-date repository docs and code access via MCP with targeted, low-hallucination queries.8.1Kstars
6gitkraken avatarGk Cligitkraken/gk-cliThe GitKraken MCP Server for managing repos, PRs, issues across GitHub, GitLab, Bitbucket and more.462stars