Access GitLab projects, merge requests, issues, commits, pipelines, and repositories
The GitLab integration lets your agents read project metadata, browse merge requests and issues, inspect commits and repository contents, watch pipelines, and post comments — against GitLab.com or any self-hosted GitLab instance.
- A Personal Access Token with
read_api scope (or api if your agent will post comments). Create one under GitLab → User Settings → Access Tokens.
- The project path in
namespace/project format (e.g., acme/my-repo).
- Base URL if you're on self-hosted GitLab. Leave blank for
gitlab.com.
- Open your agent in Agent Studio.
- In the Integrations panel, click Add Integration Config.
- Select GitLab from the integration list.
- Give the config a display name (e.g., "GitLab — Platform team").
- Enter your Personal Access Token, Project path, and (if self-hosted) Base URL.
- Save the agent revision.
- In an Agent Step, attach GitLab tools from the tools panel.
- Tools are referenced as
gitlab.list_issues, gitlab.create_merge_request_note, etc.
Write tools (create_issue, create_issue_note, create_merge_request_note) require a token with the api scope. Read-only flows are fine with read_api.
| Tool | Description | Action Type |
|---|
list_projects | List projects accessible by the authenticated user | ReadOnly |
get_project | Get details of a specific project by URL-encoded path | ReadOnly |
| Tool | Description | Action Type |
|---|
list_issues | List issues for a project | ReadOnly |
get_issue | Get a single issue from a project | ReadOnly |
create_issue | Create a new issue in a project | Irreversible |
list_issue_notes | List comments (notes) on an issue | ReadOnly |
create_issue_note | Add a comment to an issue | Irreversible |
| Tool | Description | Action Type |
|---|
list_merge_requests | List merge requests for a project | ReadOnly |
get_merge_request | Get a single merge request | ReadOnly |
get_merge_request_changes | Get the diff/changes of a merge request | ReadOnly |
list_merge_request_notes | List comments on a merge request | ReadOnly |
create_merge_request_note | Add a comment to a merge request | Irreversible |
| Tool | Description | Action Type |
|---|
list_commits | List commits in a project repository | ReadOnly |
get_commit | Get a specific commit by SHA | ReadOnly |
list_branches | List branches in a project repository | ReadOnly |
list_tags | List tags in a project repository | ReadOnly |
get_file_content | Get the content of a file from a repository | ReadOnly |
| Tool | Description | Action Type |
|---|
list_pipelines | List pipelines for a project | ReadOnly |
get_pipeline | Get a single pipeline | ReadOnly |
list_pipeline_jobs | List jobs for a specific pipeline | ReadOnly |
