# GitLab MCP Server

> GitLab MCP Server is an open-source MCP server for developer tools. Go server giving assistants GitLab merge request, pipeline and issue actions. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, self-hosted, macOS, Windows, Linux, API
- **Website:** https://docs.jmrp.io/gitlab-mcp-server
- **Repository:** https://github.com/jmrplens/gitlab-mcp-server
- **MCP Registry name:** io.github.jmrplens/gitlab-mcp-server
- **Categories:** developer tools
- **Listing updated:** 2026-11-14

## About

The design problem here is context cost. Instead of listing roughly a thousand tools, the default dynamic surface exposes two, find_action and execute_action: the assistant searches the action catalog, reads the exact schema, then runs the action. The docs report 11,396 tokens of startup context by default and 1,994 in minimal mode, versus 565,889 to 723,949 tokens if every tool were listed. Meta-tool and one-tool-per-operation surfaces are available for clients that prefer them.

It covers GitLab's REST v4 and GraphQL APIs, reaching about 876 actions on Free or Community Edition and up to about 1,103 on Ultimate, with tier-gated actions registered only if the instance's licence allows them. Calls run with your own token, so scopes still apply. Guard rails include read-only mode, safe mode that previews each write instead of executing it, tools excluded by name, and confirmation before destructive actions.

It ships as a single binary or container for Linux, macOS and Windows, using stdio locally or HTTP for a shared deployment with per-token isolation. The docs state it is not an official GitLab product.

## Features

- **Two-tool default:** find_action and execute_action reach the full catalog with a small context footprint.
- **Tier detection:** Detects Free, Premium or Ultimate and shows matching actions.
- **Safe mode:** Previews each write with its arguments instead of running it.
- **Read-only mode:** Removes every mutating action.
- **Shared HTTP deployment:** Serves many users with each credential kept separate.
- **Verifiable releases:** Signed checksums, an SBOM and build provenance per artifact.

## Good for

- Ask which merge requests need review and why a pipeline failed
- Draft release notes between two tags
- Create and assign issues from a sentence
- Run a read-only GitLab assistant for a self-managed instance

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http gitlab-mcp-server https://mcp.jmrp.io/gitlab
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.jmrp.io/gitlab
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "gitlab-mcp-server": {
      "url": "https://mcp.jmrp.io/gitlab"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "gitlab-mcp-server": {
      "type": "http",
      "url": "https://mcp.jmrp.io/gitlab"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "gitlab-mcp-server": {
      "serverUrl": "https://mcp.jmrp.io/gitlab"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "gitlab-mcp-server": {
      "type": "http",
      "url": "https://mcp.jmrp.io/gitlab"
    }
  }
}
```

## Tools

- `find_action`: Searches the action catalog in the default dynamic surface.
- `execute_action`: Runs a canonical action after reading its schema.

## FAQ

### What token do I need?

A personal, project or group access token with api scope, or read_api for actions that accept it; OAuth works in HTTP mode.

### Does it work with self-managed GitLab?

Yes, set GITLAB_URL; Community and Enterprise editions are supported.

### Can I stop it from writing?

Yes, GITLAB_MCP_READ_ONLY removes mutating actions and safe mode turns writes into previews.

### Is it official?

No. It is not an official GitLab product.

### How do I install it?

Docker image, npx -y @jmrp.io/gitlab-mcp-server, or a native binary.

### Is GitLab MCP Server free?

Yes. GitLab MCP Server is open source, so you can use and self-host it for free.

### How do I add GitLab MCP Server to Claude Code?

Run this command in your terminal: claude mcp add --transport http gitlab-mcp-server https://mcp.jmrp.io/gitlab

### What are the best alternatives to GitLab MCP Server?

The closest alternatives to GitLab MCP Server are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/gitlab-mcp-server-2
