GitLab MCP Server by zereight: Setup for Claude, Cursor and Other Apps

• Lists merge requests for you or for a project

  Without a project it lists your own merge requests. With a project it lists that project's.

  Try: “List my open merge requests.”

  Network · list_merge_requests

• Opens one merge request with its details

  Gets a merge request by its number or source branch, with optional deployment, commit and approval summaries.

  Try: “Show me merge request 123 in group/project.”

  Network · get_merge_request

• Lists the files a merge request changes

  Lists changed file paths without the diff text, so the assistant can pick which files to read.

  Try: “Which files does MR 123 change?”

  Network · list_merge_request_changed_files

• Shows the changes to chosen files in a merge request

  Gets the diffs for specific files in a merge request. The README pairs it with the changed-files list for a two-step review.

  Try: “Show the diff for src/api.ts in MR 123.”

  Network · get_merge_request_file_diff

• Lists a merge request's diffs a page at a time

  Returns merge request diffs with paging, for big merge requests.

  Try: “Page through the diffs of MR 123.”

  Network · list_merge_request_diffs

• Gets all the changes in a merge request

  Gets the changes and diffs of a merge request in one call.

  Try: “Review all the changes in MR 123.”

  Network · get_merge_request_diffs

• Shows who approved a merge request

  Gets approval details including the approvers.

  Try: “Has MR 123 been approved, and by whom?”

  Network · get_merge_request_approval_state

• Lists the comment threads on a merge request

  Lists the discussion items for a merge request.

  Try: “Show the review threads on MR 123.”

  Network · mr_discussions

• Opens one comment thread on a merge request

  Gets a single discussion item for a merge request.

  Try: “Show that review thread in full.”

  Network · get_merge_request_discussion

• Reads one comment on a merge request

  Gets a specific note for a merge request.

  Try: “Show comment 4567 on MR 123.”

  Network · get_merge_request_note

• Lists comments on a merge request

  Lists notes for a merge request.

  Try: “List the comments on MR 123.”

  Network · get_merge_request_notes

• Opens a new merge request

  Creates a merge request from a source branch to a target branch.

  Try: “Open a merge request from feature/login to main.”

  Write · create_merge_request

• Starts a review thread on a merge request

  Creates a new thread on a merge request, for example on a line of code.

  Try: “Add a review comment on line 40 of api.ts in MR 123.”

  Write · create_merge_request_thread

• Marks a review thread as resolved

  Resolves a thread on a merge request.

  Try: “Resolve the thread about the naming change.”

  Write · resolve_merge_request_thread

• Edits a merge request

  Updates a merge request, such as its title, description or state.

  Try: “Change the title of MR 123 to 'Fix login redirect'.”

  Write · update_merge_request

• Lists issues

  Lists issues. By default it shows the ones you created, and you can ask for all.

  Try: “List open issues in group/project.”

  Network · list_issues

• Lists issues assigned to you

  Lists issues assigned to the signed-in user.

  Try: “What issues are assigned to me?”

  Network · my_issues

• Opens one issue

  Gets details of an issue. It returns a short milestone by default and the full one if asked.

  Try: “Show issue 45 in group/project.”

  Network · get_issue

• Creates an issue

  Creates a new issue in a project.

  Try: “Create an issue titled 'Login fails on Safari'.”

  Write · create_issue

• Edits an issue

  Updates an issue and returns a short confirmation by default.

  Try: “Close issue 45 and add the label 'fixed'.”

  Write · update_issue

• Adds a comment to an issue

  Adds a note to an issue, optionally as a reply in a discussion thread.

  Try: “Comment on issue 45 that a fix is in review.”

  Write · create_issue_note

• Lists the comment threads on an issue

  Lists discussions for an issue.

  Try: “Show the discussion on issue 45.”

  Network · list_issue_discussions

• Changes part of an issue description

  Applies a search-and-replace or unified diff to an issue description, with a dry run to preview and an option to add a summary note.

  Try: “Change the checklist item in issue 45 without rewriting the rest.”

  Write · update_issue_description_patch

• Reads a file or folder from a project

  Gets the contents of a file or directory in a GitLab project.

  Try: “Show README.md from group/project on main.”

  Network · get_file_contents

• Lists files and folders in a repository

  Lists files and directories in a repository.

  Try: “List the top-level folders in group/project.”

  Network · get_repository_tree

• Searches for projects

  Searches GitLab projects.

  Try: “Find projects named 'billing'.”

  Network · search_repositories

• Shows a branch's latest commit and protection

  Gets branch details including its commit and protection status.

  Try: “Is main protected in group/project?”

  Network · get_branch

• Lists branches in a project

  Lists branches, with a search filter.

  Try: “List branches that start with feature/.”

  Network · list_branches

• Lists commits

  Lists repository commits with filtering options.

  Try: “Show the last 10 commits on main.”

  Network · list_commits

• Opens one commit

  Gets details of a specific commit.

  Try: “Show commit a1b2c3d.”

  Network · get_commit

• Shows what a commit changed

  Gets the changes in a specific commit.

  Try: “What did commit a1b2c3d change?”

  Network · get_commit_diff

• Shows who last changed each line of a file

  Gets git blame for a file at a given ref, optionally for a line range.

  Try: “Who last changed lines 10 to 30 of api.ts?”

  Network · get_file_blame

• Opens one project's details

  Gets details of a specific project.

  Try: “Show the details of group/project.”

  Network · get_project

• Lists projects you can access

  Lists projects accessible to the current user.

  Try: “What projects can I see?”

  Network · list_projects

• Lists who is on a project

  Lists members of a project.

  Try: “Who are the members of group/project?”

  Network · list_project_members

• Lists a project's labels

  Lists labels for a project.

  Try: “What labels does group/project use?”

  Network · list_labels

• Shows which GitLab user you are signed in as

  Gets details of the authenticated user.

  Try: “Which GitLab account is this?”

  Network · whoami

• Sends any GitLab REST call

  Sends one GitLab REST call under /api/v4. It is on only if you list the api group, and the README says it bypasses project allowlists and the per-tool safety checks.

  Try: “Call the GitLab API to list this project's deploy keys.”

  Delete · gitlab_api_request

• Used by the assistant behind the scenes

  Checks the server and your sign-in

  Verifies the server status and authentication, and reports the server version and the GitLab version.

  Try: “Check that GitLab is connected.”

  Network · health_check

• Turns on more tool groups for this session

  Lists tool categories and activates the ones you name for the session, such as pipelines or wiki. The always-on way to reach the other tools.

  Try: “Turn on the pipelines tools.”

  Read · discover_tools

• Gives a short guide to GitLab workflows

  Returns a short workflow guide, with an optional topic.

  Try: “Give me the GitLab workflow help.”

  Read · help

Watch out for

• It can switch on delete tools by itself

  The default mode is full, so the assistant can turn on groups with delete tools. Set the permission mode to readonly or modify to block that. github.com

• An optional tool bypasses the safety checks

  The api group sends any REST call and skips project allowlists and per-tool checks. It is never turned on by default or by the all setting, so leave it off. github.com

• A token can reach everything its scopes allow

  The token acts as you on GitLab. Create it with the fewest scopes you need and limit projects with the allowed-projects setting. github.com

Security advisories