A Model Context Protocol server that enables interaction with GitLab accounts to manage repositories, merge requests, code reviews, and CI/CD pipelines through natural language.
A Model Context Protocol (MCP) server that enables you to interact with your GitLab account. Get diffs, analyze merge requests, review code, cherry-pick changes, and more. This is an extended version of the MCP GitLab Server from the Model Context Protocol project.
This MCP server provides comprehensive tools for interacting with GitLab repositories, including:
git clone https://github.com/rifqi96/mcp-gitlab.git
cd mcp-gitlabnpm installnpm run buildnpm run install-hooksThis installs a pre-commit hook that automatically regenerates TOOLS.md when src/utils/tools-data.ts changes.
You need to provide your GitLab API token in the MCP settings configuration file. The token is used to authenticate with the GitLab API.
For Cursor/Roo Cline, add the following to your MCP settings file (~/Library/Application Support/Cursor/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json):
{
"mcpServers": {
"gitlab": {
"command": "node",
"args": [
"/path/to/mcp-gitlab/build/index.js"
],
"env": {
"GITLAB_API_TOKEN": "YOUR_GITLAB_API_TOKEN",
"GITLAB_API_URL": "https://gitlab.com/api/v4"
}
}
}
}For Claude Desktop, add the following to your MCP settings file (~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"gitlab": {
"command": "node",
"args": [
"/path/to/mcp-gitlab/build/index.js"
],
"env": {
"GITLAB_API_TOKEN": "YOUR_GITLAB_API_TOKEN",
"GITLAB_API_URL": "https://gitlab.com/api/v4"
}
}
}
}Replace YOUR_GITLAB_API_TOKEN with your actual GitLab API token. You can generate a token in your GitLab account under Settings > Access Tokens.
For a complete list of available tools and their parameters, see TOOLS.md.
Here are examples of how to use these tools with AI assistants that support MCP:
Could you list my GitLab projects?Can you show me the details of merge request with ID 123 in the project 'mygroup/myproject'?Please add a comment to merge request 123 in project 'mygroup/myproject' saying "This looks good, but please add more tests."Add an internal note to merge request 123 in project 'mygroup/myproject' that says "Needs security review before merging." Make sure it's only visible to team members.Update the title of merge request 123 in project 'mygroup/myproject' to "Fix login page performance issues" and update the description to include "This PR addresses the slow loading times on the login page by optimizing database queries."Compare the 'feature-branch' with 'main' in the project 'mygroup/myproject' and show me the differences.1. Show me merge request 123 in project 'mygroup/myproject'
2. Show me the changes for this merge request
3. Add an internal note with my review comments
4. Update the merge request title to better reflect the changes1. List all my GitLab projects
2. Show me the details of project 'mygroup/myproject'
3. List all branches in this project
4. Show me the content of the README.md file in the main branchList of GitLab projects accessible with your API token.
The GitLab MCP Server integrates with AI assistants that support the Model Context Protocol (MCP).
When connected to an AI assistant, this server enables the assistant to:
View and analyze code: The assistant can fetch file contents, view branch differences, and examine merge request changes for better code understanding.
Provide code reviews: The assistant can analyze merge requests and provide feedback through comments or internal notes.
Manage project workflows: The assistant can update merge request attributes, add comments, and help with repository management tasks.
Explore project structure: The assistant can browse projects, branches, and files to understand the codebase structure.
Configure CI/CD and integrations: The assistant can help set up webhooks, manage CI/CD variables, and configure project integrations.
MIT
[
{
"description": "List GitLab projects accessible to the user",
"inputSchema": {
"properties": {
"membership": {
"description": "Limit to projects the current user is a member of",
"type": "boolean"
},
"owned": {
"description": "Limit to projects explicitly owned by the current user",
"type": "boolean"
},
"per_page": {
"description": "Number of projects to return per page (max 100)",
"type": "number"
},
"search": {
"description": "Search projects by name",
"type": "string"
}
},
"type": "object"
},
"name": "gitlab_list_projects"
},
{
"description": "Get details of a specific GitLab project",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id"
],
"type": "object"
},
"name": "gitlab_get_project"
},
{
"description": "List branches of a GitLab project",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"search": {
"description": "Search branches by name",
"type": "string"
}
},
"required": [
"project_id"
],
"type": "object"
},
"name": "gitlab_list_branches"
},
{
"description": "List merge requests in a GitLab project",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"scope": {
"description": "Return merge requests for the specified scope (created_by_me, assigned_to_me, all)",
"enum": [
"created_by_me",
"assigned_to_me",
"all"
],
"type": "string"
},
"state": {
"description": "Return merge requests with specified state (opened, closed, locked, merged)",
"enum": [
"opened",
"closed",
"locked",
"merged"
],
"type": "string"
}
},
"required": [
"project_id"
],
"type": "object"
},
"name": "gitlab_list_merge_requests"
},
{
"description": "Get details of a specific merge request",
"inputSchema": {
"properties": {
"merge_request_iid": {
"description": "The internal ID of the merge request",
"type": "number"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id",
"merge_request_iid"
],
"type": "object"
},
"name": "gitlab_get_merge_request"
},
{
"description": "Get changes (diff) of a specific merge request",
"inputSchema": {
"properties": {
"merge_request_iid": {
"description": "The internal ID of the merge request",
"type": "number"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id",
"merge_request_iid"
],
"type": "object"
},
"name": "gitlab_get_merge_request_changes"
},
{
"description": "Add a comment to a merge request",
"inputSchema": {
"properties": {
"body": {
"description": "The content of the note/comment",
"type": "string"
},
"merge_request_iid": {
"description": "The internal ID of the merge request",
"type": "number"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id",
"merge_request_iid",
"body"
],
"type": "object"
},
"name": "gitlab_create_merge_request_note"
},
{
"description": "Add a comment to a merge request with option to make it an internal note",
"inputSchema": {
"properties": {
"body": {
"description": "The content of the note/comment",
"type": "string"
},
"internal": {
"description": "If true, the note will be marked as an internal note visible only to project members",
"type": "boolean"
},
"merge_request_iid": {
"description": "The internal ID of the merge request",
"type": "number"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id",
"merge_request_iid",
"body"
],
"type": "object"
},
"name": "gitlab_create_merge_request_note_internal"
},
{
"description": "Update a merge request title and description",
"inputSchema": {
"properties": {
"description": {
"description": "The description of the merge request",
"type": "string"
},
"merge_request_iid": {
"description": "The internal ID of the merge request",
"type": "number"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"title": {
"description": "The title of the merge request",
"type": "string"
}
},
"required": [
"project_id",
"merge_request_iid"
],
"type": "object"
},
"name": "gitlab_update_merge_request"
},
{
"description": "List issues in a GitLab project",
"inputSchema": {
"properties": {
"labels": {
"description": "Comma-separated list of label names",
"type": "string"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"state": {
"description": "Return issues with specified state (opened, closed)",
"enum": [
"opened",
"closed"
],
"type": "string"
}
},
"required": [
"project_id"
],
"type": "object"
},
"name": "gitlab_list_issues"
},
{
"description": "Get content of a file in a repository",
"inputSchema": {
"properties": {
"file_path": {
"description": "Path of the file in the repository",
"type": "string"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"ref": {
"description": "The name of branch, tag or commit",
"type": "string"
}
},
"required": [
"project_id",
"file_path"
],
"type": "object"
},
"name": "gitlab_get_repository_file"
},
{
"description": "Compare branches, tags or commits",
"inputSchema": {
"properties": {
"from": {
"description": "The commit SHA or branch name to compare from",
"type": "string"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"to": {
"description": "The commit SHA or branch name to compare to",
"type": "string"
}
},
"required": [
"project_id",
"from",
"to"
],
"type": "object"
},
"name": "gitlab_compare_branches"
},
{
"description": "List all available project integrations/services",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id"
],
"type": "object"
},
"name": "gitlab_list_integrations"
},
{
"description": "Get integration details for a project",
"inputSchema": {
"properties": {
"integration": {
"description": "The name of the integration (e.g., slack)",
"type": "string"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id",
"integration"
],
"type": "object"
},
"name": "gitlab_get_integration"
},
{
"description": "Update Slack integration settings for a project",
"inputSchema": {
"properties": {
"channel": {
"description": "The Slack channel name",
"type": "string"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"username": {
"description": "The Slack username",
"type": "string"
},
"webhook": {
"description": "The Slack webhook URL",
"type": "string"
}
},
"required": [
"project_id",
"webhook"
],
"type": "object"
},
"name": "gitlab_update_slack_integration"
},
{
"description": "Disable Slack integration for a project",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id"
],
"type": "object"
},
"name": "gitlab_disable_slack_integration"
},
{
"description": "List webhooks for a project",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id"
],
"type": "object"
},
"name": "gitlab_list_webhooks"
},
{
"description": "Get details of a specific webhook",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"webhook_id": {
"description": "The ID of the webhook",
"type": "number"
}
},
"required": [
"project_id",
"webhook_id"
],
"type": "object"
},
"name": "gitlab_get_webhook"
},
{
"description": "Add a new webhook to a project",
"inputSchema": {
"properties": {
"enable_ssl_verification": {
"description": "Enable SSL verification for the webhook",
"type": "boolean"
},
"issues_events": {
"description": "Trigger webhook for issues events",
"type": "boolean"
},
"merge_requests_events": {
"description": "Trigger webhook for merge request events",
"type": "boolean"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"push_events": {
"description": "Trigger webhook for push events",
"type": "boolean"
},
"token": {
"description": "Secret token to validate received payloads",
"type": "string"
},
"url": {
"description": "The webhook URL",
"type": "string"
}
},
"required": [
"project_id",
"url"
],
"type": "object"
},
"name": "gitlab_add_webhook"
},
{
"description": "Update an existing webhook",
"inputSchema": {
"properties": {
"enable_ssl_verification": {
"description": "Enable SSL verification for the webhook",
"type": "boolean"
},
"issues_events": {
"description": "Trigger webhook for issues events",
"type": "boolean"
},
"merge_requests_events": {
"description": "Trigger webhook for merge request events",
"type": "boolean"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"push_events": {
"description": "Trigger webhook for push events",
"type": "boolean"
},
"token": {
"description": "Secret token to validate received payloads",
"type": "string"
},
"url": {
"description": "The webhook URL",
"type": "string"
},
"webhook_id": {
"description": "The ID of the webhook",
"type": "number"
}
},
"required": [
"project_id",
"webhook_id",
"url"
],
"type": "object"
},
"name": "gitlab_update_webhook"
},
{
"description": "Delete a webhook",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"webhook_id": {
"description": "The ID of the webhook",
"type": "number"
}
},
"required": [
"project_id",
"webhook_id"
],
"type": "object"
},
"name": "gitlab_delete_webhook"
},
{
"description": "Test a webhook",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"webhook_id": {
"description": "The ID of the webhook",
"type": "number"
}
},
"required": [
"project_id",
"webhook_id"
],
"type": "object"
},
"name": "gitlab_test_webhook"
},
{
"description": "List pipeline trigger tokens",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id"
],
"type": "object"
},
"name": "gitlab_list_trigger_tokens"
},
{
"description": "Get details of a pipeline trigger token",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"trigger_id": {
"description": "The ID of the trigger",
"type": "number"
}
},
"required": [
"project_id",
"trigger_id"
],
"type": "object"
},
"name": "gitlab_get_trigger_token"
},
{
"description": "Create a new pipeline trigger token",
"inputSchema": {
"properties": {
"description": {
"description": "The trigger description",
"type": "string"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id",
"description"
],
"type": "object"
},
"name": "gitlab_create_trigger_token"
},
{
"description": "Update a pipeline trigger token",
"inputSchema": {
"properties": {
"description": {
"description": "The new trigger description",
"type": "string"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"trigger_id": {
"description": "The ID of the trigger",
"type": "number"
}
},
"required": [
"project_id",
"trigger_id",
"description"
],
"type": "object"
},
"name": "gitlab_update_trigger_token"
},
{
"description": "Delete a pipeline trigger token",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"trigger_id": {
"description": "The ID of the trigger",
"type": "number"
}
},
"required": [
"project_id",
"trigger_id"
],
"type": "object"
},
"name": "gitlab_delete_trigger_token"
},
{
"description": "Trigger a pipeline run",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"ref": {
"description": "The branch or tag name to run the pipeline for",
"type": "string"
},
"token": {
"description": "The trigger token",
"type": "string"
},
"variables": {
"additionalProperties": {
"type": "string"
},
"description": "Variables to pass to the pipeline",
"type": "object"
}
},
"required": [
"project_id",
"ref",
"token"
],
"type": "object"
},
"name": "gitlab_trigger_pipeline"
},
{
"description": "List CI/CD variables for a project",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id"
],
"type": "object"
},
"name": "gitlab_list_cicd_variables"
},
{
"description": "Get a specific CI/CD variable",
"inputSchema": {
"properties": {
"key": {
"description": "The key of the variable",
"type": "string"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id",
"key"
],
"type": "object"
},
"name": "gitlab_get_cicd_variable"
},
{
"description": "Create a new CI/CD variable",
"inputSchema": {
"properties": {
"key": {
"description": "The key of the variable",
"type": "string"
},
"masked": {
"description": "Whether the variable is masked",
"type": "boolean"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"protected": {
"description": "Whether the variable is protected",
"type": "boolean"
},
"value": {
"description": "The value of the variable",
"type": "string"
}
},
"required": [
"project_id",
"key",
"value"
],
"type": "object"
},
"name": "gitlab_create_cicd_variable"
},
{
"description": "Update a CI/CD variable",
"inputSchema": {
"properties": {
"key": {
"description": "The key of the variable",
"type": "string"
},
"masked": {
"description": "Whether the variable is masked",
"type": "boolean"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"protected": {
"description": "Whether the variable is protected",
"type": "boolean"
},
"value": {
"description": "The value of the variable",
"type": "string"
}
},
"required": [
"project_id",
"key",
"value"
],
"type": "object"
},
"name": "gitlab_update_cicd_variable"
},
{
"description": "Delete a CI/CD variable",
"inputSchema": {
"properties": {
"key": {
"description": "The key of the variable",
"type": "string"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id",
"key"
],
"type": "object"
},
"name": "gitlab_delete_cicd_variable"
},
{
"description": "List GitLab users",
"inputSchema": {
"properties": {
"active": {
"description": "Filter users by active status",
"type": "boolean"
},
"search": {
"description": "Search users by username, name or email",
"type": "string"
}
},
"type": "object"
},
"name": "gitlab_list_users"
},
{
"description": "Get details of a specific user",
"inputSchema": {
"properties": {
"user_id": {
"description": "The ID of the user",
"type": "number"
}
},
"required": [
"user_id"
],
"type": "object"
},
"name": "gitlab_get_user"
},
{
"description": "List GitLab groups",
"inputSchema": {
"properties": {
"owned": {
"description": "Limit to groups explicitly owned by the current user",
"type": "boolean"
},
"search": {
"description": "Search groups by name",
"type": "string"
}
},
"type": "object"
},
"name": "gitlab_list_groups"
},
{
"description": "Get details of a specific group",
"inputSchema": {
"properties": {
"group_id": {
"description": "The ID or URL-encoded path of the group",
"type": "string"
}
},
"required": [
"group_id"
],
"type": "object"
},
"name": "gitlab_get_group"
},
{
"description": "List members of a group",
"inputSchema": {
"properties": {
"group_id": {
"description": "The ID or URL-encoded path of the group",
"type": "string"
}
},
"required": [
"group_id"
],
"type": "object"
},
"name": "gitlab_list_group_members"
},
{
"description": "Add a user to a group",
"inputSchema": {
"properties": {
"access_level": {
"description": "Access level (10=Guest, 20=Reporter, 30=Developer, 40=Maintainer, 50=Owner)",
"enum": [
10,
20,
30,
40,
50
],
"type": "number"
},
"group_id": {
"description": "The ID or URL-encoded path of the group",
"type": "string"
},
"user_id": {
"description": "The ID of the user",
"type": "number"
}
},
"required": [
"group_id",
"user_id",
"access_level"
],
"type": "object"
},
"name": "gitlab_add_group_member"
},
{
"description": "List members of a project",
"inputSchema": {
"properties": {
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
}
},
"required": [
"project_id"
],
"type": "object"
},
"name": "gitlab_list_project_members"
},
{
"description": "Add a user to a project",
"inputSchema": {
"properties": {
"access_level": {
"description": "Access level (10=Guest, 20=Reporter, 30=Developer, 40=Maintainer, 50=Owner)",
"enum": [
10,
20,
30,
40,
50
],
"type": "number"
},
"project_id": {
"description": "The ID or URL-encoded path of the project",
"type": "string"
},
"user_id": {
"description": "The ID of the user",
"type": "number"
}
},
"required": [
"project_id",
"user_id",
"access_level"
],
"type": "object"
},
"name": "gitlab_add_project_member"
}
]