Enables interaction with GitLab repositories to manage merge requests, including listing open MRs, viewing MR details, accessing reviews and discussions, finding MRs for specific branches, replying to review comments, creating new discussion threads, and resolving discussions.
GitLab MCP Server
Connect your AI assistant to GitLab. Ask questions like "List open merge requests", "Show me reviews for MR #123", "Get commit discussions for MR #456", or "Find merge requests for the feature branch" directly in your chat.
Table of Contents
Quick Setup
Install the server:
git clone https://github.com/amirsina-mandegari/gitlab-mcp-server.git cd gitlab-mcp-server python -m venv .venv && source .venv/bin/activate pip install -r requirements.txt chmod +x run-mcp.shGet your GitLab token:
Go to GitLab → Settings → Access Tokens
Create token with
read_api
scopeCopy the token
Configure your project: In your project directory, create
gitlab-mcp.env
:GITLAB_PROJECT_ID=12345 GITLAB_ACCESS_TOKEN=glpat-xxxxxxxxxxxxxxxxxxxx GITLAB_URL=https://gitlab.comConnect to Cursor: Create
.cursor/mcp.json
in your project:{ "mcpServers": { "gitlab-mcp": { "command": "/path/to/gitlab-mcp-server/run-mcp.sh", "cwd": "/path/to/your-project" } } }Restart Cursor and start asking GitLab questions!
What You Can Do
Once connected, try these commands in your chat:
"List open merge requests"
"Show me details for merge request 456"
"Get reviews and discussions for MR #123"
"Show me commit discussions for MR #456"
"Get all comments on commits in merge request #789"
"Find merge requests for the feature/auth-improvements branch"
"Show me closed merge requests targeting main"
"Reply to discussion abc123 in MR #456 with 'Thanks for the feedback!'"
"Create a new review comment in MR #789 asking about the error handling"
"Resolve discussion def456 in MR #123"
Working with Review Comments
The enhanced review tools allow you to interact with merge request discussions:
First, get the reviews to see discussion IDs:
"Show me reviews for MR #123"Reply to specific discussions using the discussion ID:
"Reply to discussion abc123 in MR #456 with 'I'll fix this in the next commit'"Create new discussion threads to start conversations:
"Create a review comment in MR #789 asking 'Could you add error handling here?'"Resolve discussions when issues are addressed:
"Resolve discussion def456 in MR #123"
Note: The get_merge_request_reviews
tool now displays discussion IDs and note IDs in the output, making it easy to reference specific discussions when replying or resolving.
Working with Commit Discussions
The get_commit_discussions
tool provides comprehensive insights into discussions and comments on individual commits within a merge request:
View all commit discussions for a merge request:
"Show me commit discussions for MR #123"Get detailed commit conversation history:
"Get all comments on commits in merge request #456"
This tool is particularly useful for:
Code Review Tracking: See all feedback on specific commits
Discussion History: Understand the evolution of code discussions
Commit-Level Context: View comments tied to specific code changes
Review Progress: Monitor which commits have been discussed
Technical Implementation:
Uses
/projects/:project_id/merge_requests/:merge_request_iid/commits
to get all commits with proper paginationFetches ALL merge request discussions using
/projects/:project_id/merge_requests/:merge_request_iid/discussions
with pagination supportFilters discussions by commit SHA using position data to show commit-specific conversations
Handles both individual comments and discussion threads correctly
The output includes:
Summary of total commits and discussion counts
Individual commit details (SHA, title, author, date)
All discussions and comments for each commit with file positions
Complete conversation threads with replies
File positions for diff-related comments
Thread conversations with replies
Configuration Options
Project-Level (Recommended)
Each project gets its own gitlab-mcp.env
file with its own GitLab configuration. Keep tokens out of version control.
Global Configuration
Set environment variables system-wide instead of per-project:
Find Your Project ID
Go to your GitLab project → Settings → General → Project ID
Or check the URL:
https://gitlab.com/username/project
(use the numeric ID)
Troubleshooting
Authentication Error: Verify your token has read_api
permissions and is not expired.
Project Not Found: Double-check your project ID is correct (it's a number, not the project name).
Connection Issues: Make sure your GitLab URL is accessible and correct.
Script Not Found: Ensure the path in your MCP config points to the actual server location and the script is executable.
Tool Reference
Tool | Description | Parameters |
| List merge requests |
,
,
|
| Get MR details |
|
| Get reviews/discussions |
|
| Get discussions on commits |
|
| Find MRs for branch |
|
| Reply to existing discussion |
,
,
|
| Create new discussion thread |
,
|
| Resolve/unresolve discussion |
,
,
|
Development
Project Structure
Adding Tools
Create new file in
tools/
directoryAdd import and export to
tools/__init__.py
Add to
list_tools()
inmain.py
Add handler to
call_tool()
inmain.py
Testing
Security Notes
Add
gitlab-mcp.env
to your.gitignore
Never commit access tokens
Use project-specific tokens with minimal permissions
Rotate tokens regularly
Support
Check GitLab API documentation
Open issues at github.com/amirsina-mandegari/gitlab-mcp-server
License
MIT License - see LICENSE file for details.
This server cannot be installed
local-only server
The server can only run on the client's local machine because it depends on local resources.
Connects AI assistants to GitLab, allowing users to manage merge requests, view reviews, and interact with discussions through natural language queries.
Related MCP Servers
- -securityFlicense-qualityA custom server implementation that allows AI assistants to interact with GitLab repositories, providing capabilities for searching, fetching files, creating/updating content, and managing issues and merge requests.Last updated -1
- -securityFlicense-qualityA set of tools allowing AI assistants to interact directly with GitHub, enabling automation of tasks like fetching user profiles, creating repositories, and managing pull requests.Last updated -
- -securityFlicense-qualityProvides GitLab integration for AI assistants using Model Context Protocol, enabling repository operations, file management, issue tracking, merge requests, and branch/tag administration through natural language.Last updated -2
- AsecurityAlicenseAqualityEnables comprehensive GitLab integration allowing LLMs to manage projects, issues, merge requests, repository files, CI/CD pipelines, and perform batch operations. Supports advanced features like AI-optimized summaries, smart diffs, and atomic operations with rollback support.Last updated -72Apache 2.0