
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 toolsPublic 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*secretGitLab Personal Access Token with 'api' scope
GITLAB_PROJECT_PATHDefault project path (e.g. my-org/my-repo); can be overridden per call
GITLAB_SSL_VERIFYdefault: trueVerify SSL certificates (true/false). Set to 'false' for self-hosted GitLab with self-signed certs.
Readme
gitlab-ci-mcp
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
Details
- Repository
- github.com/mshegolev/gitlab-ci-mcp
- Category
- Developer Tools
- Package
gitlab-ci-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active