Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

MCP Gitlab

PYPI · MCP-GITLAB-CRUNCHTOOLS

Secure MCP server for GitLab projects, merge requests, issues, and pipelines

−15 this week 80 Trust /100

Last scanned (18 hours ago)

Scores higher than 80% of PyPI servers

Category Version Control

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security50
  • Malware scan not yet available for this package.Unverified
  • No known CVEs affecting this package version or its production dependencies.Pass
  • Runs hatchling.build at install time, a recognised build step with no custom scripting around it. View diagnostics → Pass
  • 1 of 22 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency100
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to crunchtools/mcp-gitlab). View diagnostics → Pass
  • Clear OSI-approved license (AGPL-3.0-or-later).Pass
  • Actively maintained (last published 3 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability79
  • AI-judged instruction clarity (excellent).Pass
  • Tool/resource definitions use about 4923 tokens (~78/item across 63 items; 63 tools + 0 resources), lean.Pass
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety75
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 0 of 9 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "delete_project_tool" implies "delete" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
  • An AI judge read all 64 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 3 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
  • 31 Oct 26 +15
    • Malware scan: unverified → pass ▲ security
  • 30 Oct 26 −14
    • Malware scan: pass → unverified ▼ security
    • Stability: 0.97 → pass security
  • 29 Oct 26 −1
    • Stability: pass → 0.97 functional
  • 24 Oct 26 +15
    • Malware scan: unverified → pass ▲ security
  • 23 Oct 26 +1
    • Stability: 0.97 → pass security
  • 22 Oct 26 −1
    • Stability: pass → 0.97 functional
  • 16 Oct 26 +1
    • Stability: 0.97 → pass security
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 4 Nov 2026 · Analysed pypi/mcp-gitlab-crunchtools@0.4.1

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem pypi
Reason Verified
Discovered via Registry attestation endpoint
Source repo crunchtools/mcp-gitlab
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/crunchtools/mcp-gitlab/.github/workflows/publish.yml@refs/heads/main
Rekor log index 1008249759
Predicate type PyPI publish attestation https://docs.pypi.org/attestations/publish/v1
Subject digest sha256:9e4ad0dbf024cae0a507f4cf9c4b7d7aa9aa1a0c647b2f88bff6d9fd6a14d723

Background: How many MCP packages publish verified provenance →

Install scripts 1 script
Hook Tier Command
build_backend allowlisted hatchling.build

Background: Why install scripts are a supply-chain risk →

Dependencies 22 packages
Packages resolved 22
Stale 1
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 63 exposed · ~4,895 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
cancel_job_tool ~38

Cancel a running CI/CD job.

NameTypeReqDescription
job_idintegeryesJob ID
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

cancel_pipeline_tool ~38

Cancel a running CI/CD pipeline.

NameTypeReqDescription
pipeline_idintegeryesPipeline ID
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

compare_branches_tool ~75

Compare two branches, tags, or commits.

NameTypeReqDescription
from_refstringyesBase branch/tag/commit
project_idstringyesProject ID or path
straightboolean–Use straight comparison instead of merge-base (default: false)
to_refstringyesHead branch/tag/commit

Structured output declared, but exposes no named fields.

No examples provided.

create_branch_tool ~58

Create a new branch in a GitLab repository.

NameTypeReqDescription
branchstringyesName of the new branch
project_idstringyesProject ID or path
refstringyesBranch name or commit SHA to create from

Structured output declared, but exposes no named fields.

No examples provided.

create_file_tool ~104

Create a new file in a GitLab repository.

NameTypeReqDescription
branchstringyesBranch to commit to
commit_messagestringyesCommit message
contentstringyesFile content (text or base64 depending on encoding)
encodingstring–Content encoding - "text" or "base64" (default: text)
file_pathstringyesPath for the new file
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

create_issue_note_tool ~55

Create a note (comment) on an issue.

NameTypeReqDescription
bodystringyesNote content (Markdown)
issue_iidintegeryesIssue internal ID
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

create_issue_tool ~95

Create a new issue in a GitLab project.

NameTypeReqDescription
assignee_ids––User IDs to assign
confidentialboolean–Whether the issue is confidential (default: false)
description––Issue description (Markdown)
labels––Comma-separated label names
milestone_id––Milestone ID
project_idstringyesProject ID or path
titlestringyesIssue title

Structured output declared, but exposes no named fields.

No examples provided.

create_label_tool ~81

Create a new label in a GitLab project.

NameTypeReqDescription
colorstringyesColor hex code (e.g., "#FF0000") or named color
description––Label description
namestringyesLabel name
priority––Label priority (lower = higher priority)
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

create_merge_request_tool ~130

Create a new merge request.

NameTypeReqDescription
assignee_ids––User IDs to assign
description––MR description (Markdown)
labels––Comma-separated label names
milestone_id––Milestone ID
project_idstringyesProject ID or path
remove_source_branchboolean–Remove source branch after merge (default: false)
reviewer_ids––User IDs to review
source_branchstringyesSource branch name (must already exist)
target_branchstringyesTarget branch name
titlestringyesMR title

Structured output declared, but exposes no named fields.

No examples provided.

create_milestone_tool ~77

Create a new milestone in a GitLab project.

NameTypeReqDescription
description––Milestone description (Markdown)
due_date––Due date (YYYY-MM-DD)
project_idstringyesProject ID or path
start_date––Start date (YYYY-MM-DD)
titlestringyesMilestone title

Structured output declared, but exposes no named fields.

No examples provided.

create_mr_discussion_tool ~58

Create a new discussion on a merge request.

NameTypeReqDescription
bodystringyesDiscussion body (Markdown)
merge_request_iidintegeryesMerge request internal ID
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

create_mr_note_tool ~59

Create a note (comment) on a merge request.

NameTypeReqDescription
bodystringyesNote content (Markdown)
merge_request_iidintegeryesMerge request internal ID
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

create_pipeline_tool ~51

Create (trigger) a new CI/CD pipeline.

NameTypeReqDescription
project_idstringyesProject ID or path
refstring–Branch or tag name to run the pipeline for (default: main)

Structured output declared, but exposes no named fields.

No examples provided.

create_project_tool ~83

Create a new GitLab project.

NameTypeReqDescription
description––Project description
initialize_with_readmeboolean–Initialize with a README file (default: false)
namestringyesProject name
namespace_id––Namespace ID to create the project under (group or user)
visibilitystring–Visibility level (public, internal, private)

Structured output declared, but exposes no named fields.

No examples provided.

create_release_tool ~106

Create a new release for a GitLab project.

NameTypeReqDescription
description––Release notes (Markdown)
name––Release title (defaults to tag_name)
project_idstringyesProject ID or path
ref––Commit SHA or branch to tag from (required if tag doesn't exist)
released_at––Release date (ISO 8601, default: now)
tag_namestringyesTag name for the release (created if it doesn't exist)

Structured output declared, but exposes no named fields.

No examples provided.

create_snippet_tool ~97

Create a new snippet in a GitLab project.

NameTypeReqDescription
contentstringyesSnippet content
description––Snippet description (Markdown)
file_namestringyesFile name for the snippet (e.g., "example.py")
project_idstringyesProject ID or path
titlestringyesSnippet title
visibilitystring–Visibility level (private, internal, public)

Structured output declared, but exposes no named fields.

No examples provided.

create_wiki_page_tool ~77

Create a new wiki page in a GitLab project.

NameTypeReqDescription
contentstringyesPage content
formatstring–Content format - markdown, rdoc, asciidoc, or org (default: markdown)
project_idstringyesProject ID or path
titlestringyesPage title

Structured output declared, but exposes no named fields.

No examples provided.

delete_branch_tool ~41

Delete a branch from a GitLab repository.

NameTypeReqDescription
branchstringyesBranch name to delete
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

delete_job_tool ~42

Delete a CI/CD job's artifacts and trace log.

NameTypeReqDescription
job_idintegeryesJob ID
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

delete_label_tool ~40

Delete a label from a GitLab project.

NameTypeReqDescription
label_idintegeryesLabel ID
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

delete_pipeline_tool ~42

Delete a CI/CD pipeline and all its jobs permanently.

NameTypeReqDescription
pipeline_idintegeryesPipeline ID
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

delete_project_tool ~38

Delete a GitLab project permanently.

NameTypeReqDescription
project_idstringyesProject ID (numeric) or path (e.g., "group/project")

Structured output declared, but exposes no named fields.

No examples provided.

get_current_user_tool ~18

Get the currently authenticated GitLab user.

Input schema present but exposes no named parameters.

Structured output declared, but exposes no named fields.

No examples provided.

get_file_tool ~73

Get a file from a GitLab repository. Returns file metadata and content (base64 encoded).

NameTypeReqDescription
file_pathstringyesPath to the file in the repository
project_idstringyesProject ID or path
refstring–Branch, tag, or commit SHA (default: HEAD)

Structured output declared, but exposes no named fields.

No examples provided.

get_group_tool ~59

Get GitLab group details by ID or path.

NameTypeReqDescription
group_idstringyesGroup ID (numeric) or path (e.g., "parent-group/child-group")
with_projectsboolean–Include group projects (default: true)

Structured output declared, but exposes no named fields.

No examples provided.

get_issue_tool ~54

Get a single issue by its IID.

NameTypeReqDescription
issue_iidintegeryesIssue internal ID (the number shown in the UI, e.g., #15)
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

get_job_log_tool ~45

Get the log (trace) output of a CI/CD job.

NameTypeReqDescription
job_idintegeryesJob ID
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

get_merge_request_tool ~58

Get a single merge request by its IID.

NameTypeReqDescription
merge_request_iidintegeryesMerge request internal ID (the number shown in the UI, e.g., !42)
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

get_mr_changes_tool ~48

Get the changes (diff) for a merge request.

NameTypeReqDescription
merge_request_iidintegeryesMerge request internal ID
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

get_pipeline_tool ~40

Get a single CI/CD pipeline by ID.

NameTypeReqDescription
pipeline_idintegeryesPipeline ID
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

get_project_branch_tool ~37

Get a single repository branch.

NameTypeReqDescription
branchstringyesBranch name
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

get_project_tool ~41

Get GitLab project details by ID or path.

NameTypeReqDescription
project_idstringyesProject ID (numeric) or path (e.g., "group/project")

Structured output declared, but exposes no named fields.

No examples provided.

get_release_tool ~42

Get a single release by tag name.

NameTypeReqDescription
project_idstringyesProject ID or path
tag_namestringyesTag associated with the release

Structured output declared, but exposes no named fields.

No examples provided.

get_user_tool ~28

Get a specific GitLab user by ID.

NameTypeReqDescription
user_idintegeryesUser ID

Structured output declared, but exposes no named fields.

No examples provided.

get_wiki_page_tool ~44

Get a single wiki page by slug.

NameTypeReqDescription
project_idstringyesProject ID or path
slugstringyesURL slug of the wiki page

Structured output declared, but exposes no named fields.

No examples provided.

list_group_projects_tool ~135

List projects within a GitLab group.

NameTypeReqDescription
group_idstringyesGroup ID or path
include_subgroupsboolean–Include projects from subgroups
order_bystring–Order by field (created_at, updated_at, name, path)
pageinteger–Page number (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
search––Filter projects by name
sortstring–Sort direction (asc, desc)
visibility––Filter by visibility (public, internal, private)

Structured output declared, but exposes no named fields.

No examples provided.

list_groups_tool ~122

List GitLab groups accessible by the API token.

NameTypeReqDescription
order_bystring–Order by field (name, path, id)
ownedboolean–Only list groups owned by the authenticated user
pageinteger–Page number (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
search––Search for groups by name
sortstring–Sort direction (asc, desc)
top_level_onlyboolean–Only list top-level groups

Structured output declared, but exposes no named fields.

No examples provided.

list_issue_notes_tool ~107

List notes (comments) on an issue.

NameTypeReqDescription
issue_iidintegeryesIssue internal ID
order_bystring–Order by field (created_at, updated_at)
pageinteger–Page number (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
project_idstringyesProject ID or path
sortstring–Sort direction (asc, desc)

Structured output declared, but exposes no named fields.

No examples provided.

list_issues_tool ~156

List issues for a GitLab project.

NameTypeReqDescription
assignee_id––Filter by assignee user ID
labels––Comma-separated label names
milestone––Milestone title
order_bystring–Order by field (created_at, updated_at, priority, due_date)
pageinteger–Page number (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
project_idstringyesProject ID or path
search––Search in title and description
sortstring–Sort direction (asc, desc)
statestring–Filter by state (opened, closed, all)

Structured output declared, but exposes no named fields.

No examples provided.

list_labels_tool ~72

List labels for a GitLab project.

NameTypeReqDescription
pageinteger–Page number (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
project_idstringyesProject ID or path
search––Filter labels by keyword

Structured output declared, but exposes no named fields.

No examples provided.

list_merge_requests_tool ~141

List merge requests for a GitLab project.

NameTypeReqDescription
labels––Comma-separated label names
milestone––Milestone title
order_bystring–Order by field (created_at, updated_at)
pageinteger–Page number (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
project_idstringyesProject ID or path
search––Search in title and description
sortstring–Sort direction (asc, desc)
statestring–Filter by state (opened, closed, merged, all)

Structured output declared, but exposes no named fields.

No examples provided.

list_milestones_tool ~89

List milestones for a GitLab project.

NameTypeReqDescription
pageinteger–Page number (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
project_idstringyesProject ID or path
search––Filter by title
statestring–Filter by state (active, closed, all)

Structured output declared, but exposes no named fields.

No examples provided.

list_mr_discussions_tool ~96

List discussions (threaded comments) on a merge request. Discussions include inline code review comments with file position data.

NameTypeReqDescription
merge_request_iidintegeryesMerge request internal ID
pageinteger–Page number (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
project_idstringyesProject ID or path

Structured output declared, but exposes no named fields.

No examples provided.

list_mr_notes_tool ~111

List notes (comments) on a merge request.

NameTypeReqDescription
merge_request_iidintegeryesMerge request internal ID
order_bystring–Order by field (created_at, updated_at)
pageinteger–Page number (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
project_idstringyesProject ID or path
sortstring–Sort direction (asc, desc)

Structured output declared, but exposes no named fields.

No examples provided.

list_pipeline_jobs_tool ~100

List jobs for a CI/CD pipeline.

NameTypeReqDescription
pageinteger–Page number (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
pipeline_idintegeryesPipeline ID
project_idstringyesProject ID or path
scope––Filter by job scope (created, pending, running, failed, success, canceled, skipped, manual)

Structured output declared, but exposes no named fields.

No examples provided.

list_pipelines_tool ~146

List CI/CD pipelines for a GitLab project.

NameTypeReqDescription
order_bystring–Order by field (id, status, ref, updated_at, user_id)
pageinteger–Page number (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
project_idstringyesProject ID or path
ref––Filter by branch or tag name
sortstring–Sort direction (asc, desc)
status––Filter by status (created, waiting_for_resource, preparing, pending, running, success, failed, canceled, skipped, manual, scheduled)

Structured output declared, but exposes no named fields.

No examples provided.

list_project_branches_tool ~75

List repository branches for a GitLab project.

NameTypeReqDescription
pageinteger–Page number (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
project_idstringyesProject ID or path
search––Filter branches by name

Structured output declared, but exposes no named fields.

No examples provided.

list_project_commits_tool ~122

List repository commits for a GitLab project.

NameTypeReqDescription
pageinteger–Page number (default: 1)
path––Only commits touching this file path
per_pageinteger–Results per page, max 100 (default: 20)
project_idstringyesProject ID or path
ref_name––Branch or tag name (default: default branch)
since––Only commits after this date (ISO 8601)
until––Only commits before this date (ISO 8601)

Structured output declared, but exposes no named fields.

No examples provided.

list_projects_tool ~144

List GitLab projects accessible by the API token.

NameTypeReqDescription
membershipboolean–Only list projects the user is a member of
order_bystring–Order by field (created_at, updated_at, name, path)
ownedboolean–Only list projects owned by the authenticated user
pageinteger–Page number for pagination (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
search––Search for projects by name
sortstring–Sort direction (asc, desc)
visibility––Filter by visibility (public, internal, private)

Structured output declared, but exposes no named fields.

No examples provided.

list_releases_tool ~94

List releases for a GitLab project.

NameTypeReqDescription
order_bystring–Order by field (released_at, created_at)
pageinteger–Page number (default: 1)
per_pageinteger–Results per page, max 100 (default: 20)
project_idstringyesProject ID or path
sortstring–Sort direction (asc, desc)

Structured output declared, but exposes no named fields.

No examples provided.

Install

How do I install the MCP Gitlab server?

MCP Gitlab runs locally as a PyPI package, launched with uvx mcp-gitlab-crunchtools. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

pypi · mcp-gitlab-crunchtools

# add to Claude Code
claude mcp add crunchtools-gitlab -- uvx mcp-gitlab-crunchtools
Common questions

What is the MCP Gitlab server?

MCP Gitlab is listed in the public MCP registry as io.github.crunchtools/gitlab. Secure MCP server for GitLab projects, merge requests, issues, and pipelines. This page covers its PyPI package (mcp-gitlab-crunchtools).

Is the MCP Gitlab server safe to use?

MCP Gitlab scores 80 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 4 November 2026. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the MCP Gitlab server expose?

MCP Gitlab exposes 63 tools: list_projects_tool, get_project_tool, list_project_branches_tool, get_project_branch_tool, list_project_commits_tool, and 58 more. Their descriptions and schemas cost roughly 4,895 tokens of context every time the server is loaded.

Is the MCP Gitlab server still maintained?

MCP Gitlab is still listed as active in the MCP registry. We last reached this channel on 4 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the MCP Gitlab server under?

MCP Gitlab declares the AGPL-3.0-or-later licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.