GitLab MCP Server
A fully typed TypeScript Model Context Protocol (MCP) server for comprehensive GitLab integration.
Quick Start
1. Get a GitLab Token
Create a GitLab Personal Access Token with api, read_user, and read_repository scopes.
2. Add to Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": ["-y", "@alosies/gitlab-mcp-server"],
"env": {
"NPM_CONFIG_TOKEN": "your-gitlab-token-here"
}
}
}
}
3. Start Using
Ask Claude things like:
- "List my GitLab projects"
- "Show me open issues in myproject"
- "Create a merge request from feature-branch to main"
- "Comment on MR #42 in myproject"
- "Show me MRs where I'm assigned as reviewer"
- "Mark MR #15 as ready for review"
- "Get the logs for job #123"
Features
- Projects: List, get details
- Issues: List, get, create
- Merge Requests: List, get, create, update with full review workflow support
- Comments & Discussions: Create notes, threaded discussions, inline code comments
- Review Management: Resolve/unresolve discussions, mark as draft/ready
- Filtering: Filter by reviewer, assignee, author
- Templates: Use GitLab MR templates for descriptions
- Pipelines: List, get, create, retry, cancel, delete
- Jobs: List jobs, get logs with advanced trace options
- Repository: List branches, get commits
- User: Get current user info
- TypeScript: Fully typed with comprehensive type definitions
Documentation
- Installation Guide - Detailed installation options and setup
- Available Tools - Complete list of tools and parameters
- Configuration - Optional configuration file setup
- Usage Examples - Real-world usage examples and workflows
- TypeScript Guide - TypeScript usage and type definitions
- Development - Contributing and development setup
Self-Hosted GitLab
For self-hosted GitLab instances, add your base URL:
{
"mcpServers": {
"gitlab": {
"command": "npx",
"args": ["-y", "@alosies/gitlab-mcp-server"],
"env": {
"NPM_CONFIG_TOKEN": "your-token",
"GITLAB_BASE_URL": "https://gitlab.mycompany.com"
}
}
}
}
Support
- Issues: GitHub Issues
- GitLab API: GitLab API Documentation
- MCP Protocol: Model Context Protocol
License
MIT License