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. It runs locally over stdio via the published package.

People connecting DevOps & monitoring tools to Claude, Cursor, VS Code, or another MCP client. The project is written in Python.

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · ★ 2 · #63 OF 101 MAINTAINED DEVOPS & MONITORING · VERIFIED 2026-08-25

MIT · Python servers · how we verify → /methodology

01 · Install GitLab CI MCP

before you install - you'll need

Set GITLAB_URL, GITLAB_TOKEN before connecting. GITLAB_PROJECT_PATH is optional or environment-specific per the README.

Claude Code

claude mcp add mshegolev-gitlab-ci-mcp -- uvx gitlab-ci-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "mshegolev-gitlab-ci-mcp": {
      "command": "uvx",
      "args": [
        "gitlab-ci-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

pypi package gitlab-ci-mcp - check the name against the project README before installing (PyPI has no namespace ownership)

registry namespace io.github.mshegolev is GitHub-verified and matches the repo owner

03 · What GitLab CI MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

Latest releases

v0.4.0 · 2026-04-17

Closes the last four optional items from the /mcp-builder best-practices checklist. · Lifespan management - asynccontextmanager hook cleans up python-gitlab HTTP sessions and the manager cache on shutdown. · MCP…

v0.3.0 · 2026-04-17

Closes four remaining gaps against the MCP server best-practices checklist. · Pagination · New pagination module with a uniform pagination block (page, per_page, total, total_pages, next_page, has_more) extracted from…

v0.2.0 · 2026-04-17

Refactor pass aligning the server with the MCP server best practices checklist. · Highlights · Tool annotations on every tool - \readOnlyHint\, \destructiveHint\, \idempotentHint\, \openWorldHint\. MCP clients can…

04 · Who maintains GitLab CI MCP

gitlab-ci-mcp is maintained by mshegolev. We track 7 MCP servers from mshegolev - 7 actively maintained, 7 combined GitHub stars, oldest repo from Apr 2026. Full record: all servers from mshegolev.

allure-testops-mcp Allure TestOps MCP - projects, launches, test cases, test results via REST API. ★ 3

05 · Facts

repository: github.com/mshegolev/gitlab-ci-mcp
category: DevOps & monitoring - ranked #63 of 101 actively-maintained DevOps & monitoring servers as of 2026-08-25.
registry: io.github.mshegolev/gitlab-ci-mcp (active, first published 2026-04-17)
packages: pypi:gitlab-ci-mcp

06 · GitLab CI MCP FAQ

What is GitLab CI MCP?

Is GitLab CI MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

How do I install GitLab CI MCP?

Run `uvx gitlab-ci-mcp`. The README documents 3 environment variables (GITLAB_URL, GITLAB_TOKEN, GITLAB_PROJECT_PATH) to set first. Set GITLAB_URL, GITLAB_TOKEN before connecting. GITLAB_PROJECT_PATH is optional or environment-specific per the README. You can also paste the ready-made client config above.

Does GitLab CI MCP run locally?

Yes - it's a stdio server: it runs on your machine (via uvx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to GitLab CI MCP

Alternatives to GitLab CI MCP

Maintained DevOps & monitoring servers if GitLab CI MCP isn't the fit.

Pairs well with

Servers that cover what GitLab CI MCP doesn't - only shown when the pairing reason fits the companion.

More DevOps & monitoring MCP servers · DevOps MCP · Monerometrics · Nslookup · Health Monitor · Infra Lens MCP

More Python MCP servers · Package Version Check MCP · OmniClip RAG · ArcGIS MCP Bridge · Ohm MCP · Data Aggregator · see all