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 · SCANNED SEP 20

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

0 this week 80 Trust /100
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 Security100
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • Runs hatchling.build at install time, a recognised native-build step with no shell scripting around it. View diagnostics → Pass
  • 1 of 23 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency35
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
  • License check failed: the license (GNU Affero General Public License v3 or later (AGPLv3+)) isn't a recognized OSI-approved license. See how to fix → Fail
  • Actively maintained (last published 202 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability80
  • AI-judged instruction clarity (excellent).Pass
  • Tool/resource definitions use about 4939 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 Management83
  • Stability observed for 25 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
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
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
// .cursor/mcp.json
{
  "mcpServers": {
    "crunchtools-gitlab": {
      "command": "uvx",
      "args": [
        "mcp-gitlab-crunchtools"
      ]
    }
  }
}
// .vscode/mcp.json
{
  "servers": {
    "crunchtools-gitlab": {
      "command": "uvx",
      "args": [
        "mcp-gitlab-crunchtools"
      ]
    }
  }
}
# add to Codex CLI
codex mcp add crunchtools-gitlab -- uvx mcp-gitlab-crunchtools
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "crunchtools-gitlab": {
      "type": "local",
      "command": [
        "uvx",
        "mcp-gitlab-crunchtools"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add crunchtools-gitlab --command uvx --arg mcp-gitlab-crunchtools
# ~/.hermes/config.yaml
mcp_servers:
  crunchtools-gitlab:
    command: "uvx"
    args: ["mcp-gitlab-crunchtools"]
// ~/.netclaw/config/netclaw.json
{
  "McpServers": {
    "crunchtools-gitlab": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "mcp-gitlab-crunchtools"
      ]
    }
  }
}
# add to Vellum
assistant mcp add crunchtools-gitlab -t stdio -c uvx -a mcp-gitlab-crunchtools
// mcp.json
{
  "mcpServers": {
    "crunchtools-gitlab": {
      "command": "uvx",
      "args": [
        "mcp-gitlab-crunchtools"
      ]
    }
  }
}
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.

  • 20 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.

  • 19 Sept 26 −3
    • Stability: pass → 0.80 functional
  • 18 Sept 26 +1
    • Stability: 0.97 → pass security
  • 15 Sept 26 +16
    • Malware scan: unverified → pass security
  • 14 Sept 26 −15
    • Malware scan: pass → unverified security
  • 13 Sept 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.

  • 12 Sept 26 +12
    • Malware scan: unverified → pass security
    • Stability: pass → 0.80 functional
  • 11 Sept 26 −14
    • Malware scan: pass → unverified security
    • 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 20 Sept 2026 · Analysed pypi/mcp-gitlab-crunchtools@0.4.1

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem pypi

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 23 packages
Packages resolved 23
Stale 1
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 63 exposed · ~4,911 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
straightbooleanUse 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)
encodingstringContent 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_idsUser IDs to assign
confidentialbooleanWhether the issue is confidential (default: false)
descriptionIssue description (Markdown)
labelsComma-separated label names
milestone_idMilestone 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
descriptionLabel description
namestringyesLabel name
priorityLabel 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_idsUser IDs to assign
descriptionMR description (Markdown)
labelsComma-separated label names
milestone_idMilestone ID
project_idstringyesProject ID or path
remove_source_branchbooleanRemove source branch after merge (default: false)
reviewer_idsUser 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
descriptionMilestone description (Markdown)
due_dateDue date (YYYY-MM-DD)
project_idstringyesProject ID or path
start_dateStart 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
refstringBranch 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
descriptionProject description
initialize_with_readmebooleanInitialize with a README file (default: false)
namestringyesProject name
namespace_idNamespace ID to create the project under (group or user)
visibilitystringVisibility 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
descriptionRelease notes (Markdown)
nameRelease title (defaults to tag_name)
project_idstringyesProject ID or path
refCommit SHA or branch to tag from (required if tag doesn't exist)
released_atRelease 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
descriptionSnippet description (Markdown)
file_namestringyesFile name for the snippet (e.g., "example.py")
project_idstringyesProject ID or path
titlestringyesSnippet title
visibilitystringVisibility 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
formatstringContent 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 ~34

Get the currently authenticated GitLab user. Returns: Current user details including ID, username, email, and permissions

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
refstringBranch, 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_projectsbooleanInclude 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_subgroupsbooleanInclude projects from subgroups
order_bystringOrder by field (created_at, updated_at, name, path)
pageintegerPage number (default: 1)
per_pageintegerResults per page, max 100 (default: 20)
searchFilter projects by name
sortstringSort direction (asc, desc)
visibilityFilter 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_bystringOrder by field (name, path, id)
ownedbooleanOnly list groups owned by the authenticated user
pageintegerPage number (default: 1)
per_pageintegerResults per page, max 100 (default: 20)
searchSearch for groups by name
sortstringSort direction (asc, desc)
top_level_onlybooleanOnly 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_bystringOrder by field (created_at, updated_at)
pageintegerPage number (default: 1)
per_pageintegerResults per page, max 100 (default: 20)
project_idstringyesProject ID or path
sortstringSort 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_idFilter by assignee user ID
labelsComma-separated label names
milestoneMilestone title
order_bystringOrder by field (created_at, updated_at, priority, due_date)
pageintegerPage number (default: 1)
per_pageintegerResults per page, max 100 (default: 20)
project_idstringyesProject ID or path
searchSearch in title and description
sortstringSort direction (asc, desc)
statestringFilter 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
pageintegerPage number (default: 1)
per_pageintegerResults per page, max 100 (default: 20)
project_idstringyesProject ID or path
searchFilter 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
labelsComma-separated label names
milestoneMilestone title
order_bystringOrder by field (created_at, updated_at)
pageintegerPage number (default: 1)
per_pageintegerResults per page, max 100 (default: 20)
project_idstringyesProject ID or path
searchSearch in title and description
sortstringSort direction (asc, desc)
statestringFilter 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
pageintegerPage number (default: 1)
per_pageintegerResults per page, max 100 (default: 20)
project_idstringyesProject ID or path
searchFilter by title
statestringFilter 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
pageintegerPage number (default: 1)
per_pageintegerResults 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_bystringOrder by field (created_at, updated_at)
pageintegerPage number (default: 1)
per_pageintegerResults per page, max 100 (default: 20)
project_idstringyesProject ID or path
sortstringSort 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
pageintegerPage number (default: 1)
per_pageintegerResults per page, max 100 (default: 20)
pipeline_idintegeryesPipeline ID
project_idstringyesProject ID or path
scopeFilter 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_bystringOrder by field (id, status, ref, updated_at, user_id)
pageintegerPage number (default: 1)
per_pageintegerResults per page, max 100 (default: 20)
project_idstringyesProject ID or path
refFilter by branch or tag name
sortstringSort direction (asc, desc)
statusFilter 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
pageintegerPage number (default: 1)
per_pageintegerResults per page, max 100 (default: 20)
project_idstringyesProject ID or path
searchFilter 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
pageintegerPage number (default: 1)
pathOnly commits touching this file path
per_pageintegerResults per page, max 100 (default: 20)
project_idstringyesProject ID or path
ref_nameBranch or tag name (default: default branch)
sinceOnly commits after this date (ISO 8601)
untilOnly 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
membershipbooleanOnly list projects the user is a member of
order_bystringOrder by field (created_at, updated_at, name, path)
ownedbooleanOnly list projects owned by the authenticated user
pageintegerPage number for pagination (default: 1)
per_pageintegerResults per page, max 100 (default: 20)
searchSearch for projects by name
sortstringSort direction (asc, desc)
visibilityFilter 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_bystringOrder by field (released_at, created_at)
pageintegerPage number (default: 1)
per_pageintegerResults per page, max 100 (default: 20)
project_idstringyesProject ID or path
sortstringSort direction (asc, desc)

Structured output declared, but exposes no named fields.

No examples provided.

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 20 September 2026. 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,911 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 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.