gitlab-mcp-server

MCP server for managing GitLab repositories — merge requests, pipelines, branches, and file operations — over the Model Context Protocol.

Features

• Merge Requests — create, list, get, review diffs, and comment
• Pipelines — list, get, retry, and cancel
• Branches — create, delete, list, and inspect
• Files — push (create/update/delete/move) and read file contents
• Enterprise support — works with any GitLab instance (set GITLAB_URL)

Installation

pip install gitlab-mcp-server

Or install from source:

git clone https://github.com/hhldiniz/gitlabmcp.git
cd gitlabmcp
pip install -e .

For tests:

pip install -e ".[test]"

Configuration

Set the following environment variables:

Variable	Required	Default	Description
GITLAB_TOKEN	Yes	—	GitLab Personal Access Token
GITLAB_URL	No	https://gitlab.com	GitLab instance URL

Usage

Run as a standalone MCP server (stdio)

export GITLAB_TOKEN=glpat-your-token
python -m gitlab_mcp_server

Configure with an MCP client

Add to your MCP client config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "gitlab": {
      "command": "python",
      "args": ["-m", "gitlab_mcp_server"],
      "env": {
        "GITLAB_TOKEN": "glpat-your-token",
        "GITLAB_URL": "https://gitlab.com"
      }
    }
  }
}

Tools

Tool	Description
create_mr	Create a merge request
list_mrs	List merge requests (filter by state)
get_mr	Get merge request details
review_code	Get MR diff/changes for code review
comment_on_mr	Add a note to a merge request
list_pipelines	List pipelines (filter by ref)
get_pipeline	Get pipeline details
retry_pipeline	Retry a failed pipeline
cancel_pipeline	Cancel a running pipeline
create_branch	Create a new branch from a ref
delete_branch	Delete a branch
list_branches	List repository branches
get_branch	Get branch details
push_files	Create/update/delete/move files in a single commit
get_file	Read a file from the repository

Running Tests

python -m pytest tests -v

Project Structure

gitlabmcp/
├── pyproject.toml
├── .env.example
├── client.py                  # Example MCP client
├── src/
│   └── gitlab_mcp_server/
│       ├── __init__.py
│       ├── __main__.py
│       ├── gitlab_client.py   # GitLab API wrapper
│       ├── tools.py           # MCP tool definitions + dispatch
│       └── server.py          # MCP server (stdio transport)
└── tests/
    ├── conftest.py            # Fixtures and mocks
    ├── test_gitlab_client.py
    ├── test_tools.py
    └── test_server.py