GITLAB MCP Tools

Total Tools: 34

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

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

• filePath (string) Required

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

• line (string) Required

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

• text (string) Required

  • Comment text
  • Example: This looks wrong

• baseSha (string) Required

  • Base commit SHA from MR diff_refs
  • Example: abc123

• headSha (string) Required

  • Head commit SHA from MR diff_refs
  • Example: def456

• startSha (string) Required

  • Start commit SHA from MR diff_refs
  • Example: abc123

Example:

dmtools gitlab_add_inline_mr_comment "value" "value"

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

gitlab_add_mr_comment

Add a general discussion comment to a GitLab merge request.

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

• text (string) Required

  • Comment text
  • Example: LGTM!

Example:

dmtools gitlab_add_mr_comment "value" "value"

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

gitlab_add_mr_label

Add a label to a GitLab merge request.

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

• label (string) Required

  • Label to add
  • Example: pr_approved

Example:

dmtools gitlab_add_mr_label "value" "value"

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

gitlab_approve_mr

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

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

Example:

dmtools gitlab_approve_mr "value" "value"

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

gitlab_cancel_job

Cancel a GitLab CI job.

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• jobId (string) Required

  • GitLab job ID
  • Example: 123456

Example:

dmtools gitlab_cancel_job "value" "value"

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

gitlab_create_mr

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

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• sourceBranch (string) Required

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

• targetBranch (string) Required

  • Target branch name
  • Example: main

• title (string) Required

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

• description (string) Optional

  • Merge request description
  • Example: Automated changes

• removeSourceBranch (string) Optional

  • Remove source branch after merge
  • Example: true

Example:

dmtools gitlab_create_mr "value" "value"

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

gitlab_create_mr_note

Create a note (comment) on a GitLab merge request. Same endpoint as gitlab_add_mr_comment; the dmtools-dart catalog exposes both names.

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

• text (string) Required

  • The note body text
  • Example: Looks good

Example:

dmtools gitlab_create_mr_note "value" "value"

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

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:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• tagName (string) Required

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

• assetName (string) Required

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

• packageName (string) Optional

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

Example:

dmtools gitlab_delete_release_asset "value" "value"

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

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:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• tagName (string) Required

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

• assetName (string) Required

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

• 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

Example:

dmtools gitlab_download_release_asset "value" "value"

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

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:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• 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("workspace", "repository");

gitlab_get_job_logs

Get GitLab CI job trace logs.

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• jobId (string) Required

  • GitLab job ID
  • Example: 123456

Example:

dmtools gitlab_get_job_logs "value" "value"

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

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:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

Example:

dmtools gitlab_get_mr "value" "value"

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

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:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

Example:

dmtools gitlab_get_mr_activities "value" "value"

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

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:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

Example:

dmtools gitlab_get_mr_comments "value" "value"

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

gitlab_get_mr_diff

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

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

Example:

dmtools gitlab_get_mr_diff "value" "value"

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

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:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

Example:

dmtools gitlab_get_mr_diff_text "value" "value"

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

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:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

Example:

dmtools gitlab_get_mr_discussions "value" "value"

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

gitlab_get_mr_pipelines

List CI pipelines for a specific GitLab merge request (the CI verdict for the MR head).

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

Example:

dmtools gitlab_get_mr_pipelines "value" "value"

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

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

• releaseName (string) Optional

  • The human-readable release name. If empty, tagName is used.
  • 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.

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:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• 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("workspace", "repository");

gitlab_list_issues

List issues in a GitLab project. State can be ‘opened’, ‘closed’, or ‘all’.

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• state (string) Optional

  • Issue state filter: opened, closed, all
  • Example: opened

• perPage (number) Optional

  • Page size (max 100)
  • Example: 50

Example:

dmtools gitlab_list_issues "value" "value"

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

gitlab_list_mrs

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

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• 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("workspace", "repository");

gitlab_list_pipeline_runs

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

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• status (string) Optional

  • Pipeline status filter
  • Example: failed

• ref (string) Optional

  • Branch or tag ref
  • Example: main

• limit (string) Optional

  • Maximum number of pipelines to return
  • Example: 50

Example:

dmtools gitlab_list_pipeline_runs "value" "value"

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

gitlab_list_project_jobs

List recent GitLab CI jobs for a project.

Parameters:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

Example:

dmtools gitlab_list_project_jobs "value" "value"

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

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:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• tagName (string) Required

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

Example:

dmtools gitlab_list_release_assets "value" "value"

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

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

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

• mergeCommitMessage (string) Optional

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

Example:

dmtools gitlab_merge_mr "value" "value"

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

gitlab_rebase_mr

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

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

Example:

dmtools gitlab_rebase_mr "value" "value"

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

gitlab_remove_mr_label

Remove a label from a GitLab merge request.

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

• label (string) Required

  • Label to remove
  • Example: pr_approved

Example:

dmtools gitlab_remove_mr_label "value" "value"

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

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

• repository (string) Required

  • Repository name
  • Example: myrepo

• pullRequestId (string) Required

  • Merge request IID
  • Example: 42

• discussionId (string) Required

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

• text (string) Required

  • Reply text
  • Example: Addressed in latest commit

Example:

dmtools gitlab_reply_to_mr_thread "value" "value"

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

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:

• workspace (string) Required

  • GitLab group or namespace
  • Example: mygroup

• repository (string) Required

  • Repository name
  • Example: myrepo

• ref (string) Required

  • Branch or tag ref
  • Example: main

• variablesJson (string) Optional

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

Example:

dmtools gitlab_trigger_pipeline "value" "value"

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

gitlab_unapprove_mr

Unapprove a GitLab merge request. Revokes your approval from the MR.

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

Example:

dmtools gitlab_unapprove_mr "value" "value"

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

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

• 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

• 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

• contentType (string) Optional

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

• packageName (string) Optional

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

• 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", "repository");