Skip to main content
Glama
godrix

@godrix/mcp-gitlab-utils

by godrix

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GITLAB_TOKENYesGitLab Personal Access Token with api and read_repository scopes
WORKTREE_DIRNoWorktree directory path (default: /tmp/referencia_ao_mcp_worktree)
GITLAB_BASE_URLYesBase URL of the GitLab instance (e.g. https://gitlab.example.com)
GITLAB_READ_ONLYNoSet to 'true' to enable read-only mode (default: false)
GITLAB_PROJECT_IDNoFallback project ID (group/repo or numeric ID)

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}
completions
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
gitlab_resolve_contextA

Discovers project_id, current branch, and merge_request_iid from repo_path. Use before other tools when working in a local clone.

gitlab_search_projectsA

Lists projects accessible by the token, with optional name or path filter.

gitlab_get_merge_requestA

Returns MR metadata: title, state, branches, reviewers, labels, head pipeline, approvals, and URL.

gitlab_get_mr_contextA

Returns MR changes/diff and optionally failed job traces and review discussions.

gitlab_get_mr_discussionsA

Lists review threads, inline comments, and general MR notes.

gitlab_get_mr_merge_statusA

Summarizes whether the MR can be merged: conflicts, draft, pipeline, approvals, blocking discussions, and actionable blockers.

gitlab_add_mr_inline_commentA

Creates a review thread on a specific diff line (file + new_line or old_line). Requires write permissions.

gitlab_manage_merge_requestsC

List, create, update, approve, merge, close, reopen, draft/ready, or comment on merge requests.

gitlab_list_pipelinesA

Lists recent project pipelines, filtering by ref (branch/tag), MR, or status.

gitlab_get_pipelineA

Returns pipeline state and job list with summary (name, stage, status, duration).

gitlab_get_job_traceA

Returns the trace (full or truncated log) for a job by job_id.

gitlab_control_pipelineC

Lists jobs, plays manual jobs, retries job/pipeline, or cancels pipeline.

gitlab_get_fileA

Returns file content at a ref (branch, tag, or commit SHA). Useful for .gitlab-ci.yml or configs without a local clone.

gitlab_compareA

Diff between two refs (branches, tags, or SHAs). Returns commits and file diffs.

gitlab_prepare_reviewA

Creates a worktree from local repo (repo_path) or shallow HTTPS clone with token. Runs npm ci or composer install by default.

Prompts

Interactive templates invoked by user choice

NameDescription
review_merge_requestAgent workflow to review an MR: context, diff, discussions, and quality checklist.
fix_failed_ciWorkflow to diagnose and fix failed jobs on the MR or branch pipeline.
create_mr_from_branchOpen a merge request with title and description from branch work.
triage_open_mrsList and prioritize open merge requests for the project or branch.
merge_merge_requestWorkflow to validate mergeability and merge (or schedule merge_when_pipeline_succeeds).

Resources

Contextual data attached and managed by the client

NameDescription
gitlab_agent_guideTool reference, context resolution, and recommended workflows.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/godrix/mcp-gitlab-utils'

If you have feedback or need assistance with the MCP directory API, please join our Discord server