Requires GitLab 18.7+ for full MCP protocol support
No direct code editing or repository file management tools
Pipeline management actions (delete, cancel) carry risk if used without oversight
Self-managed instances need additional configuration for OAuth transport
Key Features
Issue creation and retrieval with assignees, milestones, labels, and descriptionsMerge request management including commit history, file diffs, and pipeline statusCI/CD pipeline control — create, retry, cancel, delete, and list pipeline jobsSemantic code search using natural language queries across project repositoriesCross-scope search across issues, merge requests, projects, and labelsWork item comments with internal visibility options for team collaborationOAuth 2.0 Dynamic Client Registration for automatic AI tool authenticationDual transport support — HTTP (recommended) and stdio with mcp-remote
Pricing
Free
GitLab MCP Server is completely free to use with no hidden costs.
GitLab MCP Server is GitLab's official Model Context Protocol server that connects AI tools to your GitLab instance for secure, real-time interaction with projects, issues, merge requests, and CI/CD pipelines. It supports both HTTP and stdio transport types and works with Claude Desktop, Claude Code, Cursor, VS Code, and other MCP-compatible clients.
The server provides tools for creating and retrieving issues with full metadata (assignees, milestones, labels), managing merge requests including commit history and file diffs, controlling CI/CD pipelines (create, retry, cancel, delete), and performing cross-scope search across issues, merge requests, and projects. A semantic code search tool uses natural language to find relevant code snippets. Work item collaboration tools let AI assistants add and retrieve comments with internal visibility options.
Authentication uses OAuth 2.0 Dynamic Client Registration, allowing AI tools to register themselves automatically when connecting for the first time. The server respects all existing GitLab permission controls and supports both GitLab.com and self-managed instances. It implements the 2025-03-26 and 2025-06-18 MCP protocol specifications starting from GitLab 18.7.
Does GitLab MCP Server work with self-managed GitLab instances?
Yes. It supports both GitLab.com and self-managed instances. For self-managed, you need GitLab 18.7 or later and may need additional configuration for OAuth transport. The stdio transport with mcp-remote can simplify setup for on-premises deployments.
Can the AI assistant push code through GitLab MCP?
No. The server manages issues, merge requests, pipelines, and search but does not include tools for editing files or pushing commits directly. You would use a Git MCP server or local Git tooling for code changes, then manage the resulting MRs through GitLab MCP.
How does semantic code search differ from regular search?
Regular search matches exact text strings. Semantic code search uses natural language understanding to find code by intent — for example, searching for "authentication middleware" finds relevant code even if those exact words do not appear. It uses GitLab's AI-powered code search infrastructure.
Is authentication handled automatically?
Yes, via OAuth 2.0 Dynamic Client Registration. When your AI client connects for the first time, it registers itself with GitLab automatically. You approve the authorization once, and subsequent connections reuse the credentials without manual token management.