mcp-gitlab

A Model Context Protocol (MCP) server that enables AI assistants to interact with GitLab. This server provides tools to view and manage merge requests, get project information, and perform review actions.

• 🔍 View Merge Requests: See MRs you created or need to review
• 📋 Get MR Details: Get comprehensive information about specific merge requests
• ✅ Review Actions: Approve or unapprove merge requests
• 📝 Update MRs: Modify titles, descriptions, and states
• 🏗️ Project Management: List accessible GitLab projects

1. Clone this repository:

git clone <repository-url>
cd mcp-gitlab

1. Install dependencies:

npm install

1. Build the project:

npm run build

1. Set up environment variables:

cp sample.env .env
# Edit .env with your GitLab configuration

Create a .env file with the following variables:

GITLAB_URL=https://gitlab.com
GITLAB_TOKEN=your_gitlab_personal_access_token_here

1. Go to your GitLab instance (e.g., gitlab.com)
2. Navigate to User Settings → Access Tokens
3. Create a new token with the following scopes:

• api - Full API access
• read_user - Read user information
• read_repository - Read repository information

Get merge requests created by the current user.

Parameters:

• state (optional): Filter by state (opened, closed, merged, all). Default: opened

Get merge requests assigned to the current user for review.

Parameters:

• state (optional): Filter by state (opened, closed, merged, all). Default: opened

Get detailed information about a specific merge request.

Parameters:

• project_id (required): The project ID
• merge_request_iid (required): The merge request IID (internal ID)