Integrate GitLab into the workflow. Can manage projects, issues, merge requests, pipelines, and add comments. Supports all core GitLab DevOps operations.
List GitLab projects accessible to the authenticated user
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
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 |
total | number | Total number of projects |
Get details of a specific GitLab project
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
projectId | string | Yes | Project ID or URL-encoded path (e.g., "namespace/project") |
| Parameter | Type | Description |
|---|
project | object | The GitLab project details |
List issues in a GitLab project
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
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 |
total | number | Total number of issues |
Get details of a specific GitLab issue
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
projectId | string | Yes | Project ID or URL-encoded path |
issueIid | number | Yes | Issue number within the project (the # shown in GitLab UI) |
| Parameter | Type | Description |
|---|
issue | object | The GitLab issue details |
Create a new issue in a GitLab project
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
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 |
| Parameter | Type | Description |
|---|
issue | object | The created GitLab issue |
Update an existing issue in a GitLab project
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
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 |
| Parameter | Type | Description |
|---|
issue | object | The updated GitLab issue |
Delete an issue from a GitLab project
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
projectId | string | Yes | Project ID or URL-encoded path |
issueIid | number | Yes | Issue internal ID (IID) |
| Parameter | Type | Description |
|---|
success | boolean | Whether the issue was deleted successfully |
Add a comment to a GitLab issue
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
projectId | string | Yes | Project ID or URL-encoded path |
issueIid | number | Yes | Issue internal ID (IID) |
body | string | Yes | Comment body (Markdown supported) |
| Parameter | Type | Description |
|---|
note | object | The created comment |
List merge requests in a GitLab project
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
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 |
total | number | Total number of merge requests |
Get details of a specific GitLab merge request
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
projectId | string | Yes | Project ID or URL-encoded path |
mergeRequestIid | number | Yes | Merge request internal ID (IID) |
| Parameter | Type | Description |
|---|
mergeRequest | object | The GitLab merge request details |
Create a new merge request in a GitLab project
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
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) |
| Parameter | Type | Description |
|---|
mergeRequest | object | The created GitLab merge request |
Update an existing merge request in a GitLab project
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
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) |
| Parameter | Type | Description |
|---|
mergeRequest | object | The updated GitLab merge request |
Merge a merge request in a GitLab project
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
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 |
| Parameter | Type | Description |
|---|
mergeRequest | object | The merged GitLab merge request |
Add a comment to a GitLab merge request
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
projectId | string | Yes | Project ID or URL-encoded path |
mergeRequestIid | number | Yes | Merge request internal ID (IID) |
body | string | Yes | Comment body (Markdown supported) |
| Parameter | Type | Description |
|---|
note | object | The created comment |
List pipelines in a GitLab project
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
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 |
total | number | Total number of pipelines |
Get details of a specific GitLab pipeline
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
projectId | string | Yes | Project ID or URL-encoded path |
pipelineId | number | Yes | Pipeline ID |
| Parameter | Type | Description |
|---|
pipeline | object | The GitLab pipeline details |
Trigger a new pipeline in a GitLab project
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
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) |
| Parameter | Type | Description |
|---|
pipeline | object | The created GitLab pipeline |
Retry a failed GitLab pipeline
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
projectId | string | Yes | Project ID or URL-encoded path |
pipelineId | number | Yes | Pipeline ID |
| Parameter | Type | Description |
|---|
pipeline | object | The retried GitLab pipeline |
Cancel a running GitLab pipeline
| Parameter | Type | Required | Description |
|---|
accessToken | string | Yes | GitLab Personal Access Token |
projectId | string | Yes | Project ID or URL-encoded path |
pipelineId | number | Yes | Pipeline ID |
| Parameter | Type | Description |
|---|
pipeline | object | The cancelled GitLab pipeline |
- Category:
tools
- Type:
gitlab
