# Gitlab Mcp

> A Model Context Protocol (MCP) server that provides GitLab integration tools for Claude Code.

- **Type:** MCP server
- **Install:** `agentstack add mcp-sgaunet-gitlab-mcp`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [sgaunet](https://agentstack.voostack.com/s/sgaunet)
- **Installs:** 0
- **Category:** [Developer Tools](https://agentstack.voostack.com/c/developer-tools)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [sgaunet](https://github.com/sgaunet)
- **Source:** https://github.com/sgaunet/gitlab-mcp

## Install

```sh
agentstack add mcp-sgaunet-gitlab-mcp
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

[](https://github.com/sgaunet/gitlab-mcp/releases/latest)
[](https://goreportcard.com/report/github.com/sgaunet/gitlab-mcp)

[](https://github.com/sgaunet/gitlab-mcp/actions/workflows/coverage.yml)
[](https://github.com/sgaunet/gitlab-mcp/actions/workflows/snapshot.yml)
[](https://github.com/sgaunet/gitlab-mcp/actions/workflows/release.yml)
[](https://github.com/sgaunet/gitlab-mcp/actions/workflows/vulnerability-scan.yml)
[](LICENSE)

# GitLab MCP Server

A Model Context Protocol (MCP) server that provides GitLab integration tools for Claude Code. Interact with GitLab projects, issues, epics, and CI/CD pipelines directly from Claude.

## Features

- **Issue Management**: List, create, update issues, and add comments
- **Label Management**: List and manage project labels with filtering
- **Project Management**: View and update project descriptions and topics
- **Epic Management**: List and create epics (Premium/Ultimate tier)
- **CI/CD Integration**: Monitor pipelines, view job logs, and download traces
- **Direct Project Access**: Use project paths (namespace/project-name) without ID resolution
- **MCP Architecture**: Seamless integration with Claude Code via stdio communication

## Quick Start

### Prerequisites

- GitLab personal access token with `api`, `read_api`, and `write_api` scopes
- Claude Code CLI installed
- Docker (optional, for containerized deployment)

[Detailed setup instructions →](docs/SETUP.md)

### Installation

```bash
# Install via Homebrew (Recommended for macOS/Linux)
brew tap sgaunet/homebrew-tools
brew install sgaunet/tools/gitlab-mcp
```

### Configuration

```bash
# Set your GitLab token
export GITLAB_TOKEN=your_personal_access_token

# Optional: For self-hosted GitLab
export GITLAB_URI=https://your.gitlab.instance
```

### Add to Claude Code

```bash
# Apple Silicon Mac
claude mcp add gitlab-mcp -s user -- /opt/homebrew/bin/gitlab-mcp

# Intel Mac / Linux
claude mcp add gitlab-mcp -s user -- /usr/local/bin/gitlab-mcp
```

### CLI Flags (Optional)

Optimize token usage by disabling tool categories you don't need:

```bash
# Example: CI/CD debugging only
gitlab-mcp --no-issues --no-labels --no-project-metadata --no-epics

# Example: Issue management only
gitlab-mcp --no-project-metadata --no-epics --no-pipelines
```

Available flags: `--no-issues`, `--no-labels`, `--no-project-metadata`, `--no-epics`, `--no-pipelines`

[Complete CLI configuration →](docs/SETUP.md#cli-flags)

### First Usage

```
List all open issues for project myorg/myproject
```

```
Create an issue with title "Bug fix needed" for project myorg/myproject
```

```
Get the latest pipeline for myorg/myproject
```

## Documentation

- **[Setup Guide](docs/SETUP.md)** - Installation, configuration, and Claude Code integration
- **[Docker Deployment](docs/DOCKER.md)** - Container-based deployment and Docker Compose
- **[Tool Reference](docs/TOOLS.md)** - Complete documentation for all available tools
- **[Development Guide](docs/DEVELOPMENT.md)** - Contributing, testing, and development workflow
- **[Troubleshooting](docs/TROUBLESHOOTING.md)** - Common issues and solutions
- **[Contributing](docs/CONTRIBUTING.md)** - How to contribute to the project

## Available Tools

| Tool | Description |
|------|-------------|
| `list_issues` | List project and group issues with filtering |
| `create_issues` | Create new issues with labels and assignees |
| `update_issues` | Update issue title, description, state, labels |
| `add_issue_note` | Add comments to issues |
| `list_labels` | List project labels with optional filtering |
| `get_project_description` | Get project description |
| `update_project_description` | Update project description |
| `get_project_topics` | Get project topics/tags |
| `update_project_topics` | Update project topics/tags |
| `list_epics` | List epics for a group (Premium/Ultimate) |
| `create_epic` | Create epics (Premium/Ultimate) |
| `get_latest_pipeline` | Get latest CI/CD pipeline |
| `list_pipeline_jobs` | List pipeline jobs with filtering |
| `get_job_log` | Get complete job log output |
| `download_job_trace` | Download job logs to files |

[Complete tool documentation →](docs/TOOLS.md)

## License

MIT License. See [LICENSE](LICENSE) for details.

## Support

For issues, questions, or feature requests, please [create an issue](https://github.com/sgaunet/gitlab-mcp/issues) in the repository.

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [sgaunet](https://github.com/sgaunet)
- **Source:** [sgaunet/gitlab-mcp](https://github.com/sgaunet/gitlab-mcp)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-sgaunet-gitlab-mcp
- Seller: https://agentstack.voostack.com/s/sgaunet
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.