Skip to content

About this project

GitLab MCP Server is an independent, MIT-licensed Model Context Protocol server that exposes the GitLab REST v4 and GraphQL APIs as tools an AI assistant can call. It is written in Go, ships as a single static binary, and currently covers 847 operations on GitLab Community Edition and up to 1071 on GitLab.com.

The project is built and maintained by José Manuel Requena Plens (jmrplens), an R&D firmware and software engineer based in Valencia, Spain, working on industrial embedded systems, open-source tooling, and self-hosted infrastructure.

GitHubgithub.com/jmrplens
Websitejmrp.io
ORCID0000-0003-1250-6212
Google ScholarProfile
Mastodon@jmrplens@mstdn.jmrp.io
LinkedInin/jmrplens

Most GitLab MCP integrations expose a curated slice of the API — enough to read a merge request or open an issue — because a hand-maintained tool list is easier to keep coherent. This project started from the opposite premise: generate the whole API surface from the catalog, so an operation is never missing merely because nobody got round to adding it, and keep it working on Community Edition with nothing but a personal access token.

That created a second problem. A server that registers a thousand tools costs more startup context than most models can spare, which is why the default surface is two tools rather than a thousand. The dynamic toolset resolves any operation on demand, and the architecture page records the design decisions that follow from it.

This is an independent open-source project. It is not affiliated with, endorsed by, or operated by GitLab Inc., and it communicates with GitLab only through the documented public APIs. GitLab is a trademark of its respective owner. GitLab publishes its own official MCP integration separately; see the comparison page for how the two differ.

The project is released under the MIT license and follows semantic versioning. Current version: 2.6.1.

Every release publishes signed binaries for Linux, macOS and Windows on both amd64 and arm64, a container image on GHCR and Docker Hub, and a Claude Desktop extension. Release notes and downloads are on the Releases page; binary signatures can be verified with Cosign as described under release integrity.

Bug reports and feature requests belong in GitHub Issues. Include the output of gitlab-mcp-server --version, the transport (stdio or HTTP), the TOOL_SURFACE in use, and the GitLab edition and version you connect to — those four facts resolve most reports immediately.

Security vulnerabilities are different: do not open a public issue. Use GitHub Security Advisories, which keeps the report private until a fix ships. The full policy is in SECURITY.md.

Frequently asked questions

Who maintains GitLab MCP Server?

GitLab MCP Server is built and maintained by José Manuel Requena Plens (jmrplens), an R&D firmware and software engineer based in Valencia, Spain, working on industrial embedded systems, open-source tooling, and self-hosted infrastructure. Research identity: ORCID 0000-0003-1250-6212. It is an independent open-source project and is not affiliated with, endorsed by, or operated by GitLab Inc.

Is GitLab MCP Server affiliated with GitLab Inc.?

No. It is an independent open-source project that talks to GitLab through the public REST v4 and GraphQL APIs, exactly as any other API client would. GitLab is a trademark of GitLab Inc.; this project uses the name only to describe what it connects to. GitLab also publishes its own official MCP integration, which is a separate product with different instance prerequisites.

How is GitLab MCP Server licensed?

Under the MIT license, with the full source on GitHub. There is no paid tier, no license key, and no hosted service you must subscribe to. GitLab Premium and Ultimate tools register only when the GitLab instance you connect to is licensed for those features — that gating comes from your own GitLab licence, not from this server.

How do I report a bug or request a feature?

Open an issue on the GitHub repository. For security vulnerabilities, do not open a public issue — use GitHub Security Advisories instead, as described on the security page. Bug reports are most useful when they include the output of gitlab-mcp-server --version, the transport in use (stdio or HTTP), the tool surface (TOOL_SURFACE), and the GitLab edition and version you connect to.

How often is GitLab MCP Server released?

Releases are cut as work lands rather than on a fixed calendar, and versioning follows semantic versioning. Every release publishes signed cross-platform binaries for Linux, macOS, and Windows on amd64 and arm64, a container image, and a Claude Desktop extension. The built-in auto-update checks GitHub Releases and can apply updates for you; it is documented on the auto-update page.