# mcp-gitlab

> MCP server for the GitLab REST API. It gives AI assistants 83 tools, 7 resources, and 6 prompts to manage projects, merge requests, pipelines, CI/CD, approvals, issues, and code reviews.

MCP server that wraps the GitLab REST API. Works with GitLab.com and self-hosted instances (CE/EE). No GitLab Duo or Premium required. Built with FastMCP, httpx, and Pydantic.

- **Install**: `uvx mcp-gitlab`
- **Version**: 0.14.0
- **Python**: >=3.10
- **License**: MIT
- **Protocol**: MCP 2026-07-28 (MCP 2.0); compatible with 2025-11-25 clients; built on FastMCP 4.x
- **Transport**: stdio (default), streamable-http (recommended for remote), SSE (deprecated by the 2026-07-28 spec)
- **Registry**: `io.github.vish288/mcp-gitlab`
- **Required env vars**: `GITLAB_URL` (instance URL), `GITLAB_TOKEN` (personal access token with `api` scope)
- **Optional env vars**: `GITLAB_READ_ONLY` (disable writes), `GITLAB_TIMEOUT` (request timeout), `GITLAB_SSL_VERIFY` (SSL verification), `GITLAB_AUTH` (`token` default or `oauth` for per-user OAuth 2.1; see Configuration)

## Documentation

- [README](https://github.com/vish288/mcp-gitlab#readme): canonical reference for setup, env vars, all 83 tools, 7 resources, 6 prompts
- [PyPI](https://pypi.org/project/mcp-gitlab/): install via `pip install mcp-gitlab` or `uvx mcp-gitlab`
- [GitHub](https://github.com/vish288/mcp-gitlab): source code, issue tracker, development setup
- [MCP Registry](https://registry.modelcontextprotocol.io): discover and install MCP servers

## Optional

- [Changelog](https://github.com/vish288/mcp-gitlab/releases): per-version release notes with breaking changes
- [MCP Specification](https://modelcontextprotocol.io/docs): protocol spec for tools, resources, and prompts
- [FastMCP](https://github.com/jlowin/fastmcp): Python framework this server is built on
