GITLAB MCP Tools

Total Tools: 30

Quick Reference

# List all gitlab tools
dmtools list | jq '.tools[] | select(.name | startswith("gitlab_"))'

# Example usage
dmtools gitlab_test [arguments]

Usage in JavaScript Agents

// Direct function calls for gitlab tools
const result = gitlab_test(...);
const result = gitlab_get_mr_comments(...);
const result = gitlab_add_mr_label(...);

Available Tools

Detailed Parameter Information

gitlab_add_inline_mr_comment

Create a new inline code review comment on a specific file and line in a GitLab merge request. Requires base_sha, head_sha, start_sha from the MR diff refs (use gitlab_get_mr to get them from diff_refs).

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• line (string) Required

  • Line number in the new file to comment on
  • Example: 42

• startSha (string) Required

  • Start commit SHA from MR diff_refs
  • Example: abc123

• filePath (string) Required

  • Path to the file to comment on
  • Example: src/main/Foo.java

• baseSha (string) Required

  • Base commit SHA from MR diff_refs
  • Example: abc123

• text (string) Required

  • Comment text
  • Example: This looks wrong

• headSha (string) Required

  • Head commit SHA from MR diff_refs
  • Example: def456

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

Example:

dmtools gitlab_add_inline_mr_comment "value" "value"

// In JavaScript agent
const result = gitlab_add_inline_mr_comment("workspace", "line");

gitlab_add_mr_comment

Add a general discussion comment to a GitLab merge request.

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• text (string) Required

  • Comment text
  • Example: LGTM!

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

Example:

dmtools gitlab_add_mr_comment "value" "value"

// In JavaScript agent
const result = gitlab_add_mr_comment("workspace", "text");

gitlab_add_mr_label

Add a label to a GitLab merge request.

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• label (string) Required

  • Label to add
  • Example: pr_approved

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

Example:

dmtools gitlab_add_mr_label "value" "value"

// In JavaScript agent
const result = gitlab_add_mr_label("workspace", "label");

gitlab_approve_mr

Approve a GitLab merge request. Adds your approval to the MR.

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

Example:

dmtools gitlab_approve_mr "value" "value"

// In JavaScript agent
const result = gitlab_approve_mr("repository", "pullRequestId");

gitlab_cancel_job

Cancel a GitLab CI job.

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• jobId (string) Required

  • GitLab job ID
  • Example: 123456

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

Example:

dmtools gitlab_cancel_job "value" "value"

// In JavaScript agent
const result = gitlab_cancel_job("repository", "jobId");

gitlab_create_mr

Create a GitLab merge request from a source branch into a target branch.

Parameters:

• removeSourceBranch (string) Optional

  • Remove source branch after merge
  • Example: true

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• targetBranch (string) Required

  • Target branch name
  • Example: main

• sourceBranch (string) Required

  • Source branch name
  • Example: feature/PROJ-123

• description (string) Optional

  • Merge request description
  • Example: Automated changes

• repository (string) Required

  • Repository name
  • Example: myrepo

• title (string) Required

  • Merge request title
  • Example: PROJ-123 Implement feature

Example:

dmtools gitlab_create_mr "value" "value"

// In JavaScript agent
const result = gitlab_create_mr("removeSourceBranch", "workspace");

gitlab_delete_release_asset

Delete a GitLab release asset by its asset name. Removes both the release link and the underlying Generic Package Registry file. Use gitlab_list_release_assets to find asset names.

Parameters:

• assetName (string) Required

  • The name of the asset to delete, as returned by gitlab_list_release_assets.
  • Example: clip_123.png

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• packageName (string) Optional

  • Optional Generic Package Registry package name the asset was uploaded under. Defaults to ‘release-assets’.
  • Example: release-assets

• repository (string) Required

  • Repository name
  • Example: myrepo

• tagName (string) Required

  • The tag name of the release.
  • Example: pr-attachments-storage

Example:

dmtools gitlab_delete_release_asset "value" "value"

// In JavaScript agent
const result = gitlab_delete_release_asset("assetName", "workspace");

gitlab_download_release_asset

Download a GitLab release asset (a file published to the Generic Package Registry and attached to a release) to a local file path.

Parameters:

• assetName (string) Required

  • The name of the asset to download, as returned by gitlab_list_release_assets.
  • Example: clip_123.png

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• targetFilePath (string) Required

  • Local file path where the downloaded asset should be saved.
  • Example: /tmp/downloaded_clip_123.png

• packageName (string) Optional

  • Optional Generic Package Registry package name the asset was uploaded under. Defaults to ‘release-assets’.
  • Example: release-assets

• repository (string) Required

  • Repository name
  • Example: myrepo

• tagName (string) Required

  • The tag name of the release.
  • Example: pr-attachments-storage

Example:

dmtools gitlab_download_release_asset "value" "value"

// In JavaScript agent
const result = gitlab_download_release_asset("assetName", "workspace");

gitlab_get_commit_statuses

Get CI/CD statuses for a commit SHA in a GitLab project. Returns one entry per status report (e.g. posted by an external CI like Jenkins via the gitlabBuilds plugin, or GitLab’s own pipeline). Equivalent of GitHub’s ‘check runs’ for GitLab. When the same status name was reported more than once for this commit (e.g. a CI job was retried), only the most recent report per name is returned.

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• commitSha (string) Required

  • The commit SHA to get statuses for
  • Example: abc123...

Example:

dmtools gitlab_get_commit_statuses "value" "value"

// In JavaScript agent
const result = gitlab_get_commit_statuses("repository", "workspace");

gitlab_get_job_logs

Get GitLab CI job trace logs.

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• jobId (string) Required

  • GitLab job ID
  • Example: 123456

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

Example:

dmtools gitlab_get_job_logs "value" "value"

// In JavaScript agent
const result = gitlab_get_job_logs("repository", "jobId");

gitlab_get_mr

Get details of a specific GitLab merge request including title, description, state, author, diff_refs (base_sha, head_sha, start_sha needed for inline comments).

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

Example:

dmtools gitlab_get_mr "value" "value"

// In JavaScript agent
const result = gitlab_get_mr("repository", "pullRequestId");

gitlab_get_mr_activities

Get all activities for a GitLab merge request. Approvals are fetched from the real GitLab Approvals API. General discussion notes are also included.

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

Example:

dmtools gitlab_get_mr_activities "value" "value"

// In JavaScript agent
const result = gitlab_get_mr_activities("repository", "pullRequestId");

gitlab_get_mr_comments

Get all comments for a GitLab merge request, including both inline code review comments (DiffNote) and general discussion notes. Excludes system-generated notes.

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

Example:

dmtools gitlab_get_mr_comments "value" "value"

// In JavaScript agent
const result = gitlab_get_mr_comments("repository", "pullRequestId");

gitlab_get_mr_diff

Get diff stats and changed files for a GitLab merge request.

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

Example:

dmtools gitlab_get_mr_diff "value" "value"

// In JavaScript agent
const result = gitlab_get_mr_diff("repository", "pullRequestId");

gitlab_get_mr_diff_text

Get the raw unified diff text for a GitLab merge request (suitable for locating file/line positions, e.g. for inline review comments).

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

Example:

dmtools gitlab_get_mr_diff_text "value" "value"

// In JavaScript agent
const result = gitlab_get_mr_diff_text("repository", "pullRequestId");

gitlab_get_mr_discussions

Get all discussion threads for a GitLab merge request. Each discussion contains notes (comments) and a resolved status. Use the discussion id with gitlab_resolve_mr_thread.

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

Example:

dmtools gitlab_get_mr_discussions "value" "value"

// In JavaScript agent
const result = gitlab_get_mr_discussions("repository", "pullRequestId");

gitlab_get_or_create_release

Find an existing GitLab release by tag, or create one if it does not exist. Useful for a stable artefact storage release (mirrors github_get_or_create_draft_release). Note: GitLab releases have no draft concept; releases are visible as soon as they are created.

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• tagName (string) Required

  • The Git tag name for the release. Reused to find an existing release.
  • Example: pr-attachments-storage

• targetCommitish (string) Optional

  • Optional branch or commit SHA the release’s tag should point to when created (GitLab ‘ref’). Required if the tag does not already exist.
  • Example: main

• body (string) Optional

  • Optional Markdown release notes/description.
  • Example: Internal storage release for PR attachments.

• releaseName (string) Optional

  • The human-readable release name. If empty, tagName is used.
  • Example: PR Attachments Storage

Example:

dmtools gitlab_get_or_create_release "value" "value"

// In JavaScript agent
const result = gitlab_get_or_create_release("workspace", "repository");

gitlab_get_pipeline_jobs

List jobs for a GitLab CI pipeline.

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• pipelineId (string) Required

  • GitLab pipeline ID
  • Example: 123456

Example:

dmtools gitlab_get_pipeline_jobs "value" "value"

// In JavaScript agent
const result = gitlab_get_pipeline_jobs("repository", "workspace");

gitlab_list_mrs

List merge requests for a GitLab project. State can be ‘opened’, ‘closed’, ‘merged’, or ‘all’.

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• state (string) Required

  • MR state: opened, closed, merged, all. ‘open’ is also accepted as a synonym for ‘opened’.
  • Example: opened

Example:

dmtools gitlab_list_mrs "value" "value"

// In JavaScript agent
const result = gitlab_list_mrs("repository", "workspace");

gitlab_list_pipeline_runs

List recent GitLab CI pipelines. Optionally filter by status, ref, and limit.

Parameters:

• limit (string) Optional

  • Maximum number of pipelines to return
  • Example: 50

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• ref (string) Optional

  • Branch or tag ref
  • Example: main

• repository (string) Required

  • Repository name
  • Example: myrepo

• status (string) Optional

  • Pipeline status filter
  • Example: failed

Example:

dmtools gitlab_list_pipeline_runs "value" "value"

// In JavaScript agent
const result = gitlab_list_pipeline_runs("limit", "workspace");

gitlab_list_project_jobs

List recent GitLab CI jobs for a project.

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

Example:

dmtools gitlab_list_project_jobs "value" "value"

// In JavaScript agent
const result = gitlab_list_project_jobs("repository", "workspace");

gitlab_list_release_assets

List all assets (asset links) attached to a GitLab release. Returns a JSON array of link objects including id, name, url, and direct_asset_url.

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• tagName (string) Required

  • The tag name of the release.
  • Example: pr-attachments-storage

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

Example:

dmtools gitlab_list_release_assets "value" "value"

// In JavaScript agent
const result = gitlab_list_release_assets("repository", "tagName");

gitlab_merge_mr

Merge a GitLab merge request. Optionally provide a custom merge commit message.

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• mergeCommitMessage (string) Optional

  • Optional custom merge commit message
  • Example: Merge feature branch

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

Example:

dmtools gitlab_merge_mr "value" "value"

// In JavaScript agent
const result = gitlab_merge_mr("workspace", "mergeCommitMessage");

gitlab_rebase_mr

Ask GitLab to rebase/update a merge request source branch with its target branch.

Parameters:

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

Example:

dmtools gitlab_rebase_mr "value" "value"

// In JavaScript agent
const result = gitlab_rebase_mr("repository", "pullRequestId");

gitlab_remove_mr_label

Remove a label from a GitLab merge request.

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• label (string) Required

  • Label to remove
  • Example: pr_approved

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

Example:

dmtools gitlab_remove_mr_label "value" "value"

// In JavaScript agent
const result = gitlab_remove_mr_label("workspace", "label");

gitlab_reply_to_mr_thread

Reply to an existing discussion thread in a GitLab merge request. Use the discussion id from gitlab_get_mr_discussions.

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• text (string) Required

  • Reply text
  • Example: Addressed in latest commit

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

• discussionId (string) Required

  • Discussion thread ID
  • Example: 6a9c1750b37d57bba1079be3bbd13a...

Example:

dmtools gitlab_reply_to_mr_thread "value" "value"

// In JavaScript agent
const result = gitlab_reply_to_mr_thread("workspace", "text");

gitlab_resolve_mr_thread

Resolve (close) a review discussion thread in a GitLab merge request. Use the discussion id from gitlab_get_mr_discussions.

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

• discussionId (string) Required

  • Discussion thread ID to resolve
  • Example: 6a9c1750b37d57bba1079be3bbd13a...

Example:

dmtools gitlab_resolve_mr_thread "value" "value"

// In JavaScript agent
const result = gitlab_resolve_mr_thread("workspace", "repository");

gitlab_test

Test GitLab connectivity by fetching the current user’s profile

Parameters: None

Example:

dmtools gitlab_test

// In JavaScript agent
const result = gitlab_test();

gitlab_trigger_pipeline

Trigger a GitLab CI pipeline for a branch or tag using the authenticated API token.

Parameters:

• variablesJson (string) Optional

  • Optional JSON object of CI variables
  • Example: {"CONFIG_FILE":"agents/story_development.json"}

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• ref (string) Required

  • Branch or tag ref
  • Example: main

• repository (string) Required

  • Repository name
  • Example: myrepo

Example:

dmtools gitlab_trigger_pipeline "value" "value"

// In JavaScript agent
const result = gitlab_trigger_pipeline("variablesJson", "workspace");

gitlab_upload_release_asset

Upload a local file as a GitLab release asset. Internally publishes the file to the project’s Generic Package Registry and attaches it to the release as an asset link, so it is discoverable the same way as a GitHub release asset. Returns the release link metadata including direct_asset_url. Set overwrite=true to automatically replace an existing asset with the same name before uploading (GitLab’s Generic Package Registry rejects duplicate uploads with 409 Conflict otherwise).

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• filePath (string) Required

  • Absolute or relative path to the local file to upload.
  • Example: /tmp/preview.png

• assetName (string) Optional

  • Optional asset filename shown in GitLab. Defaults to the local filename.
  • Example: clip_123.png

• packageName (string) Optional

  • Optional Generic Package Registry package name used to group the uploaded files. Defaults to ‘release-assets’.
  • Example: release-assets

• repository (string) Required

  • Repository name
  • Example: myrepo

• tagName (string) Required

  • The tag name of the release returned by gitlab_get_or_create_release.
  • Example: pr-attachments-storage

• contentType (string) Optional

  • Optional MIME type. Defaults to detected type or application/octet-stream.
  • Example: image/png

• overwrite (string) Optional

  • If true, delete any existing asset (release link + underlying generic package file) with the same name before uploading. Defaults to false.
  • Example: true

Example:

dmtools gitlab_upload_release_asset "value" "value"

// In JavaScript agent
const result = gitlab_upload_release_asset("workspace", "filePath");