gitlab-mcp
MCP server for GitLab: 288 tools for projects, MRs, issues, pipelines, wikis and more via the GitLab REST/GraphQL API
What is gitlab-mcp?
MCP server for GitLab: 288 tools for projects, MRs, issues, pipelines, wikis and more via the GitLab REST/GraphQL API
Overview of gitlab-mcp
What it is
GitLab MCP Server is an MCP (Model Context Protocol) server that provides tools for interacting with GitLab through its REST and GraphQL APIs. By default, it exposes 40 tools (38 core tools plus discover_tools and help), while a total of 290 tools exist across all categories. It supports stdio, SSE, and Streamable HTTP transports, and can be used with MCP clients such as Claude, Cursor, VS Code, and GitHub Copilot.
Key features
- 290 tools covering projects, merge requests, issues, pipelines, wiki, releases, tags, milestones, and more - Default 40 tools to keep token budget low; call
discover_toolsto activate additional categories per session - Supports multiple authentication methods: Personal Access Token (PAT), OAuth, read-only mode, and remote authorization - Dynamic API URL configuration - Skill + CLI path that does not require MCP registration - Agent-paste prompt for easy setup in new workspaces
Use cases
- Review merge requests: use
list_merge_request_changed_filesthen batchedget_merge_request_file_diff - Inspect pipeline job logs: use
get_pipeline_job_outputwith pagination - Specify project and merge request using URL-encodedproject_idandmerge_request_iid
Getting started
Install the binary: bash npm install -g @zereight/mcp-gitlab Or via Homebrew: bash brew tap zereight/gitlab-mcp https://github.com/zereight/gitlab-mcp brew install zereight/gitlab-mcp/zereight-mcp-gitlab Set your GitLab Personal Access Token: bash read -rs GITLAB_PERSONAL_ACCESS_TOKEN && export GITLAB_PERSONAL_ACCESS_TOKEN Add the MCP server to your client (example for Claude Code): bash claude mcp add gitlab --transport stdio --scope local --env GITLAB_PERSONAL_ACCESS_TOKEN=$GITLAB_PERSONAL_ACCESS_TOKEN --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab For Codex: bash codex mcp add gitlab --env GITLAB_PERSONAL_ACCESS_TOKEN=$GITLAB_PERSONAL_ACCESS_TOKEN --env GITLAB_API_URL=https://gitlab.com/api/v4 -- zereight-mcp-gitlab One-liner: npx -y @zereight/mcp-gitlab@latest
License and pricing
License: MIT. Pricing: open source (no cost).
Based on the project's public README and repository metadata.