GitLab
Interact with GitLab projects, issues, merge requests, and pipelines
Configuration
List Projects
gitlab_list_projects)List GitLab projects accessible to the authenticated user
| Parameter | Type | Required | Description |
|---|---|---|---|
owned | boolean | No | Limit to projects owned by the current user |
membership | boolean | No | Limit to projects the current user is a member of |
search | string | No | Search projects by name |
visibility | string | No | Filter by visibility (public, internal, private) |
orderBy | string | No | Order by field (id, name, path, created_at, updated_at, last_activity_at) |
sort | string | No | Sort direction (asc, desc) |
perPage | number | No | Number of results per page (default 20, max 100) |
page | number | No | Page number for pagination |
| Parameter | Type | Description |
|---|---|---|
projects | array | List of GitLab projects |
Get Project
gitlab_get_project)Get details of a specific GitLab project
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path (e.g., "namespace/project") |
Refer to the block outputs for this operation.
List Issues
gitlab_list_issues)List issues in a GitLab project
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
state | string | No | Filter by state (opened, closed, all) |
labels | string | No | Comma-separated list of label names |
assigneeId | number | No | Filter by assignee user ID |
milestoneTitle | string | No | Filter by milestone title |
search | string | No | Search issues by title and description |
orderBy | string | No | Order by field (created_at, updated_at) |
sort | string | No | Sort direction (asc, desc) |
perPage | number | No | Number of results per page (default 20, max 100) |
page | number | No | Page number for pagination |
| Parameter | Type | Description |
|---|---|---|
issues | array | List of GitLab issues |
Get Issue
gitlab_get_issue)Get details of a specific GitLab issue
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
issueIid | number | Yes | Issue number within the project (the # shown in GitLab UI) |
Refer to the block outputs for this operation.
Create Issue
gitlab_create_issue)Create a new issue in a GitLab project
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
title | string | Yes | Issue title |
description | string | No | Issue description (Markdown supported) |
labels | string | No | Comma-separated list of label names |
assigneeIds | array | No | Array of user IDs to assign |
milestoneId | number | No | Milestone ID to assign |
dueDate | string | No | Due date in YYYY-MM-DD format |
confidential | boolean | No | Whether the issue is confidential |
Refer to the block outputs for this operation.
Update Issue
gitlab_update_issue)Update an existing issue in a GitLab project
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
issueIid | number | Yes | Issue internal ID (IID) |
title | string | No | New issue title |
description | string | No | New issue description (Markdown supported) |
stateEvent | string | No | State event (close or reopen) |
labels | string | No | Comma-separated list of label names |
assigneeIds | array | No | Array of user IDs to assign |
milestoneId | number | No | Milestone ID to assign |
dueDate | string | No | Due date in YYYY-MM-DD format |
confidential | boolean | No | Whether the issue is confidential |
Refer to the block outputs for this operation.
Delete Issue
gitlab_delete_issue)Delete an issue from a GitLab project
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
issueIid | number | Yes | Issue internal ID (IID) |
Refer to the block outputs for this operation.
Add Issue Comment
gitlab_create_issue_note)Add a comment to a GitLab issue
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
issueIid | number | Yes | Issue internal ID (IID) |
body | string | Yes | Comment body (Markdown supported) |
Refer to the block outputs for this operation.
List Merge Requests
gitlab_list_merge_requests)List merge requests in a GitLab project
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
state | string | No | Filter by state (opened, closed, merged, all) |
labels | string | No | Comma-separated list of label names |
sourceBranch | string | No | Filter by source branch |
targetBranch | string | No | Filter by target branch |
orderBy | string | No | Order by field (created_at, updated_at) |
sort | string | No | Sort direction (asc, desc) |
perPage | number | No | Number of results per page (default 20, max 100) |
page | number | No | Page number for pagination |
| Parameter | Type | Description |
|---|---|---|
mergeRequests | array | List of GitLab merge requests |
Get Merge Request
gitlab_get_merge_request)Get details of a specific GitLab merge request
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
mergeRequestIid | number | Yes | Merge request internal ID (IID) |
Refer to the block outputs for this operation.
Create Merge Request
gitlab_create_merge_request)Create a new merge request in a GitLab project
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
sourceBranch | string | Yes | Source branch name |
targetBranch | string | Yes | Target branch name |
title | string | Yes | Merge request title |
description | string | No | Merge request description (Markdown supported) |
labels | string | No | Comma-separated list of label names |
assigneeIds | array | No | Array of user IDs to assign |
milestoneId | number | No | Milestone ID to assign |
removeSourceBranch | boolean | No | Delete source branch after merge |
squash | boolean | No | Squash commits on merge |
draft | boolean | No | Mark as draft (work in progress) |
Refer to the block outputs for this operation.
Update Merge Request
gitlab_update_merge_request)Update an existing merge request in a GitLab project
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
mergeRequestIid | number | Yes | Merge request internal ID (IID) |
title | string | No | New merge request title |
description | string | No | New merge request description |
stateEvent | string | No | State event (close or reopen) |
labels | string | No | Comma-separated list of label names |
assigneeIds | array | No | Array of user IDs to assign |
milestoneId | number | No | Milestone ID to assign |
targetBranch | string | No | New target branch |
removeSourceBranch | boolean | No | Delete source branch after merge |
squash | boolean | No | Squash commits on merge |
draft | boolean | No | Mark as draft (work in progress) |
Refer to the block outputs for this operation.
Merge Merge Request
gitlab_merge_merge_request)Merge a merge request in a GitLab project
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
mergeRequestIid | number | Yes | Merge request internal ID (IID) |
mergeCommitMessage | string | No | Custom merge commit message |
squashCommitMessage | string | No | Custom squash commit message |
squash | boolean | No | Squash commits before merging |
shouldRemoveSourceBranch | boolean | No | Delete source branch after merge |
mergeWhenPipelineSucceeds | boolean | No | Merge when pipeline succeeds |
Refer to the block outputs for this operation.
Add MR Comment
gitlab_create_merge_request_note)Add a comment to a GitLab merge request
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
mergeRequestIid | number | Yes | Merge request internal ID (IID) |
body | string | Yes | Comment body (Markdown supported) |
Refer to the block outputs for this operation.
List Pipelines
gitlab_list_pipelines)List pipelines in a GitLab project
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
ref | string | No | Filter by ref (branch or tag) |
status | string | No | Filter by status (created, waiting_for_resource, preparing, pending, running, success, failed, canceled, skipped, manual, scheduled) |
orderBy | string | No | Order by field (id, status, ref, updated_at, user_id) |
sort | string | No | Sort direction (asc, desc) |
perPage | number | No | Number of results per page (default 20, max 100) |
page | number | No | Page number for pagination |
| Parameter | Type | Description |
|---|---|---|
pipelines | array | List of GitLab pipelines |
Get Pipeline
gitlab_get_pipeline)Get details of a specific GitLab pipeline
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
pipelineId | number | Yes | Pipeline ID |
Refer to the block outputs for this operation.
Create Pipeline
gitlab_create_pipeline)Trigger a new pipeline in a GitLab project
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
ref | string | Yes | Branch or tag to run the pipeline on |
variables | array | No | Array of variables for the pipeline (each with key, value, and optional variable_type) |
Refer to the block outputs for this operation.
Retry Pipeline
gitlab_retry_pipeline)Retry a failed GitLab pipeline
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
pipelineId | number | Yes | Pipeline ID |
Refer to the block outputs for this operation.
Cancel Pipeline
gitlab_cancel_pipeline)Cancel a running GitLab pipeline
| Parameter | Type | Required | Description |
|---|---|---|---|
projectId | string | Yes | Project ID or URL-encoded path |
pipelineId | number | Yes | Pipeline ID |
Refer to the block outputs for this operation.
Usage Instructions
Integrate GitLab into the workflow. Can manage projects, issues, merge requests, pipelines, and add comments. Supports all core GitLab DevOps operations.
Notes
- Category:
tools - Type:
gitlab