Complete GitLab MCP integration with 72 specialized tools for comprehensive DevOps management
Overview
A comprehensive Model Context Protocol (MCP) server for GitLab integration with Claude Desktop, providing 72 specialized tools covering every aspect of GitLab project management.
Installation
NPM Package
# For GitLab.com
npx @sekora/gitlab-mcp
# For self-hosted GitLab
GITLAB_URL="https://gitlab.company.com" GITLAB_TOKEN="your-token" npx @sekora/gitlab-mcp
Claude Desktop Configuration
{
"mcpServers": {
"gitlab-mcp": {
"command": "npx",
"args": ["@sekora/gitlab-mcp"],
"env": {
"GITLAB_TOKEN": "your-gitlab-private-token"
}
}
}
}
Tool Categories (72 Tools - 100% Complete)
Issue Management (8 tools)
- Create, update, close, and link issues
- Milestone and label management
- Advanced filtering and search
Pipeline & Job Management (17 tools)
- Pipeline monitoring, triggering, and analytics
- Job execution, retry, and artifact management
- Real-time status monitoring
Merge Request Management (8 tools)
- Complete MR lifecycle from creation to merge
- Review comments and conflict resolution
- Approval workflows and validation
Repository Management (8 tools)
- Branch and file operations
- Commit history and tag management
- Release management with assets
Security & Quality Analysis (6 tools)
- SAST, dependency, and container scanning
- License compliance and code quality metrics
- Vulnerability assessment and remediation
Environment & Deployment (7 tools)
- Environment monitoring and feature flags
- Deployment tracking and GitLab Pages management
- Runner and variable management
Project Administration (6 tools)
- Member and permission management
- Project settings and integrations
- Webhook and access token management
Analytics & Insights (4 tools)
- Project analytics and contributor statistics
- Activity monitoring and usage metrics
- Performance trends and optimization insights
Team Collaboration (4 tools)
- Discussions and mentions management
- Wiki pages and code snippets
- Team communication workflows
Specialized Monitoring (6 tools)
- Advanced pipeline analytics and dashboards
- Success rate analysis and performance metrics
- Cross-project monitoring and alerts
Key Features
- Complete GitLab Coverage: Every major GitLab feature accessible through Claude
- Multi-Instance Support: Configure multiple GitLab instances simultaneously
- Enterprise Ready: Supports GitLab CE, Premium, and Ultimate editions
- Security First: Built-in token management and secure authentication
- Rich Analytics: Comprehensive insights and performance monitoring
- Type-Safe: Built with TypeScript and Zod validation
- Production Ready: Comprehensive error handling and validation
Requirements
- Node.js 18.19.0+
- GitLab private access token with api scope
- GitLab.com or self-hosted GitLab instance
Authentication
Create a GitLab private access token:
1. Go to GitLab → Profile → Access Tokens
2. Create token with api scope
3. Configure via environment variable or Claude Desktop config
Multi-Tenant Support
Configure multiple GitLab instances:
{
"mcpServers": {
"work-gitlab": {
"command": "npx",
"args": ["@sekora/gitlab-mcp"],
"env": {
"GITLAB_URL": "https://gitlab.company.com",
"GITLAB_TOKEN": "work-token"
}
},
"personal-gitlab": {
"command": "npx",
"args": ["@sekora/gitlab-mcp"],
"env": {
"GITLAB_TOKEN": "personal-token"
}
}
}
}
Use Cases
- DevOps Automation: Pipeline monitoring, deployment management, environment control
- Code Review: MR creation, approval workflows, conflict resolution
- Project Management: Issue tracking, milestone planning, team coordination
- Security Operations: Vulnerability scanning, compliance monitoring, quality analysis
- Team Collaboration: Wiki management, discussions, activity monitoring
- Analytics & Reporting: Project insights, contributor analysis, performance metrics
Built with the https://mcp-framework.com for reliable, type-safe GitLab API integration.
Server Config
{
"mcpServers": {
"gitlab-mcp": {
"command": "npx",
"args": [
"@sekora/gitlab-mcp@latest"
],
"env": {
"GITLAB_TOKEN": "your-gitlab-private-token"
}
}
}
}