Skip to main content

GitLab

Connect to GitLab to manage projects, issues, merge requests, and repositories.

Categories: Development Tools, Version Control, Project Management

What you can ask​

  • List every merge request in acme/backend that's been open more than 5 days.
  • Create a merge request from feature/payments into develop and request review from the payments team.
  • Find every pipeline that failed in the last 24 hours, grouped by job stage.

Set up​

GitLab is ready to enable, and an admin doesn't need to create anything first.

  1. Go to Organization > Connectors and find GitLab.
  2. Click Enable and choose which tools to allow.
  3. Each member connects their own account the first time they use it.

To use one account for the whole organization, turn on Share one connection with everyone. Every member's agents then act as that account, with exactly the access it has.

You can also use your own OAuth application instead of the shared one. Create it in the GitLab developer portal, then enter its details under Use your own OAuth application.

Tools​

GitLab offers 97 tools. Admins choose which ones agents can use. See Tool permission groups.

Read (38)​

View and search information without changing it.

ToolWhat it does
get_branchGet detailed information about a specific branch by project ID and branch name, including commit details, merge status, protection status, and access permissions
get_commitGet detailed information about a specific commit by project ID and commit SHA, including message, author, committer, timestamps, parent commits, stats, and complete commit metadata
get_commit_diffGet the diff of changes introduced by a specific commit, showing file modifications, additions, deletions, and detailed line-by-line changes
get_current_userGet information about the currently authenticated user including username, name, email, permissions, namespace, private token details, and complete profile information for the API credential in use
get_fileGet a file from a repository with base64-encoded content, metadata, blob ID, commit ID, size, encoding, and last commit information for file inspection and content retrieval
get_groupGet detailed information about a specific group by ID or path, including name, description, visibility, avatar, projects, members, statistics, and complete group metadata
get_issueGet comprehensive detailed information about a specific GitLab issue by project ID and issue IID including description, state, labels, assignees, time tracking, and linked resources
get_issue_noteGet detailed information about a specific note/comment on an issue by project ID, issue IID, and note ID
get_jobGet detailed information about a specific CI/CD job by project ID and job ID, including status, stage, name, duration, artifacts, runner, user, commit, and complete execution metadata
get_job_traceGet the log trace output of a CI/CD job showing all console output, script execution, build logs, and job execution details, essential for debugging failed jobs and monitoring job progress
get_labelGet detailed information about a specific label by project ID and label ID, including name, description, color, priority, and usage statistics
get_merge_requestGet detailed information about a specific merge request by project ID and MR IID, including description, state, branches, assignees, reviewers, pipeline status, merge status, conflicts, approvals, and time tracking
get_merge_request_noteGet detailed information about a specific note/comment on a merge request by project ID, MR IID, and note ID
get_milestoneGet detailed information about a specific milestone by project ID and milestone ID, including title, description, state, dates, progress, and issue/MR counts
get_pipelineGet detailed information about a specific CI/CD pipeline by project ID and pipeline ID, including status, source, ref, SHA, user, timestamps, duration, coverage, jobs, and detailed status information
get_projectGet comprehensive detailed information about a specific GitLab project by ID or URL-encoded path including repository details, statistics, permissions, and configuration
get_raw_fileGet the raw content of a file from a repository (plain text or binary) without base64 encoding for direct content access and display
get_time_statsGet time tracking statistics for an issue including time estimate, total time spent, and remaining time in both seconds and human-readable format
get_userGet detailed information about a specific user by user ID, including username, name, email, avatar, state, bio, location, organization, job title, creation date, and complete profile information
get_webhookGet detailed information about a specific webhook by project ID and hook ID, including URL, event triggers, SSL verification, and configuration
list_branchesList all branches in a project repository with optional search filtering and pagination support for navigating branch lists in large repositories
list_commit_commentsList all comments on a specific commit showing discussions, code review feedback, and inline comments with author, timestamps, and comment content
list_commitsList all commits in a project repository with comprehensive filtering by ref, date range, path, author, and more, plus pagination support for exploring repository history
list_groupsList all accessible groups in GitLab with comprehensive filtering by search query, owned groups, top-level groups, visibility, and more, plus pagination support for large group directories
list_issue_notesList all comments/notes on a specific issue with author, timestamps, content, and pagination support for tracking discussions and feedback
list_issuesList all issues in a GitLab project with comprehensive filtering by state, labels, milestone, assignee, author, search query, and date ranges, plus pagination support for large issue collections
list_jobsList all CI/CD jobs in a GitLab project with filtering by scope (created, pending, running, failed, success, canceled, skipped, manual) and pagination support for comprehensive job tracking and monitoring
list_labelsList all labels in a project with optional issue and merge request counts, color, description, and pagination support for label management and organization
list_merge_request_notesList all comments/notes on a specific merge request with author, timestamps, content, and pagination support for code review and discussion tracking
list_merge_requestsList all merge requests in a GitLab project with comprehensive filtering by state, labels, assignee, reviewer, source/target branch, draft status, and date ranges, plus pagination support for large MR collections
list_milestonesList all milestones in a project with filtering by state (active, closed, all), title search, and pagination support for milestone management and sprint planning
list_pipeline_jobsList all CI/CD jobs in a specific pipeline with optional filtering by scope, showing all job stages, statuses, and execution details for pipeline-specific job tracking and debugging
list_pipelinesList all CI/CD pipelines in a GitLab project with comprehensive filtering by scope, status, source, ref, SHA, YAML errors, username, and update dates, plus pagination support for large pipeline collections
list_projectsList all accessible GitLab projects with comprehensive filtering including archived status, visibility level, ownership, membership, and starred projects, plus pagination support for large project collections
list_usersList all users in GitLab instance with comprehensive filtering by username, search query, active/blocked status, external users, and more, plus pagination support for large user directories
list_webhooksList all webhooks configured for a project with URL, token, event triggers, and enable status for webhook management and integration monitoring
star_projectStar a GitLab project to add it to your favorites list for quick access and to show appreciation for the project
validate_credentialValidate GitLab credentials.

Write (18)​

Create or send data.

ToolWhat it does
add_spent_timeAdd time spent working on an issue using human-readable format (e.g., '3h30m', '1h', '2d') for time tracking and project management
create_branchCreate a new branch from a specified source branch, tag, or commit SHA with branch name and ref, enabling parallel development workflows and feature branching
create_commitCreate a commit with multiple file operations in one atomic commit.
create_commit_commentCreate a new comment on a commit with optional inline file and line reference for code review, feedback, and commit discussions
create_fileCreate a new file in a repository with specified content, commit message, branch, and encoding for adding files programmatically
create_groupCreate a new group or subgroup with specified name, path, visibility, description, and settings for organizing projects and managing access across multiple repositories
create_issueCreate a new GitLab issue with title, description, labels, assignees, milestone, due date, and confidentiality settings for comprehensive issue tracking
create_issue_noteCreate a new comment/note on an issue with Markdown content for adding feedback, discussion, and collaboration
create_labelCreate a new label with specified name, color, and optional description and priority for issue and merge request categorization and filtering
create_merge_requestCreate a new merge request with source branch, target branch, title, description, assignees, reviewers, labels, milestone, and merge settings including squash commits and remove source branch options
create_merge_request_noteCreate a new comment/note on a merge request with Markdown content for code review feedback, discussion, and collaboration
create_milestoneCreate a new milestone with title, description, and optional due date and start date for sprint planning, release management, and goal tracking
create_pipelineTrigger a new CI/CD pipeline run for a specified branch or tag with optional variables, manually initiating the CI/CD workflow for testing, deployment, or continuous integration
create_projectCreate a new GitLab project with specified name, path, namespace, description, visibility level, and initialization options including automatic README generation
create_userCreate a new user account with username, email, password, and optional profile settings, admin-only operation for user provisioning and account management
create_webhookCreate a new webhook with URL, secret token, and comprehensive event trigger configuration for push, issues, merge requests, pipelines, deployments, and more
fork_projectCreate a complete fork of a GitLab project to a specified namespace with optional custom name, path, and description for independent development
retry_jobRetry a failed or canceled CI/CD job, creating a new job instance and rerunning it with the same configuration, useful for handling transient failures and flaky tests

Delete or overwrite (41)​

Remove or replace existing data.

ToolWhat it does
approve_merge_requestApprove a merge request to indicate review approval and satisfy approval rules, contributing to the required approvals count before the merge request can be merged
archive_projectArchive a GitLab project to make it read-only and hide it from most project lists while preserving all data and repository access
cancel_jobCancel a running or pending CI/CD job immediately, stopping job execution and transitioning it to canceled status, useful for stopping incorrect or unnecessary job runs
cancel_pipelineCancel a running CI/CD pipeline and all its jobs, immediately stopping all running jobs and preventing pending jobs from starting, useful for stopping incorrect or unnecessary pipeline runs
delete_branchDelete a branch from a project repository permanently, removing the branch reference but preserving commits in the repository history if they are referenced elsewhere
delete_fileDelete a file from a repository with specified commit message, branch, and optional last commit ID verification for file removal
delete_groupDelete a group and all its projects, subgroups, and associated data permanently, asynchronous operation that schedules group deletion (requires owner permissions)
delete_issuePermanently delete a GitLab issue by project ID and issue IID including all its comments, attachments, and metadata (irreversible operation)
delete_issue_noteDelete a comment/note from an issue permanently, removing the comment from the discussion history
delete_labelDelete a label from a project permanently, removing the label from all issues and merge requests that use it
delete_merge_requestDelete a merge request from a project by project ID and MR IID, permanently removing the merge request and all associated data including comments, approvals, and metadata
delete_merge_request_noteDelete a comment/note from a merge request permanently, removing the comment from the code review discussion history
delete_milestoneDelete a milestone from a project permanently, removing the milestone but preserving associated issues and merge requests
delete_pipelineDelete a CI/CD pipeline and all its associated data including jobs, artifacts, and logs, permanently removing the pipeline from the project history
delete_projectPermanently delete a GitLab project by ID or path including all its data, issues, merge requests, and repository content (irreversible asynchronous operation)
delete_userDelete a user account permanently from GitLab, removing the user and optionally hard-deleting all associated data including projects, issues, and contributions (admin only)
delete_webhookDelete a webhook from a project permanently, removing the integration and stopping all event notifications
erase_jobErase a CI/CD job's artifacts and trace log permanently, removing build outputs and logs while keeping job metadata and status, useful for removing sensitive data or large artifacts
merge_merge_requestAccept and merge a merge request with optional custom commit message, squash commits, auto-remove source branch, and merge when pipeline succeeds settings, completing the code review and integration process
move_issueMove a GitLab issue from one project to another project while preserving history, comments, and metadata, creating a new issue IID in the target project
play_jobTrigger a manual CI/CD job to run with optional variables, starting jobs that require manual action and supporting parameterized manual job execution for controlled deployments and operations
protect_branchProtect a branch with push and merge access level restrictions, allowed users/groups, code owner approval requirements, and unprotect access control for enforcing branch protection policies
reset_spent_timeReset the spent time for an issue to zero, removing all time tracking records while preserving the time estimate
reset_time_estimateReset the time estimate for an issue to zero, removing the estimate while preserving time spent records
retry_pipelineRetry all failed jobs in a CI/CD pipeline, rerunning only the jobs that failed while keeping successful jobs unchanged, useful for transient failures and flaky tests
set_time_estimateSet or update the time estimate for an issue using human-readable format (e.g., '3h30m', '2d') for project planning and resource allocation
unapprove_merge_requestRemove approval from a merge request, retracting the authenticated user's previous approval and decreasing the approvals count
unarchive_projectUnarchive a previously archived GitLab project to restore it to active status with full read-write access and normal visibility
unprotect_branchRemove protection from a branch to allow unrestricted access, disabling all branch protection rules and access level restrictions
unstar_projectUnstar a previously starred GitLab project to remove it from your favorites list
update_fileUpdate an existing file in a repository with new content, commit message, and optional last commit ID verification for file modification
update_groupUpdate an existing group's name, path, description, visibility, settings, and permissions for modifying group configuration and access control
update_issueUpdate an existing GitLab issue's title, description, state, labels, assignees, milestone, or other properties with support for state transitions and label management
update_issue_noteUpdate an existing comment/note on an issue to modify content or mark as resolved
update_labelUpdate an existing label's name, color, description, or priority for modifying label appearance and organization
update_merge_requestUpdate an existing merge request's title, description, state, target branch, assignees, reviewers, labels, milestone, squash settings, and other properties including discussion lock and remove source branch options
update_merge_request_noteUpdate an existing comment/note on a merge request to modify content or resolve discussions
update_milestoneUpdate an existing milestone's title, description, dates, or state (activate/close) for modifying sprint plans and release schedules
update_projectUpdate an existing GitLab project's name, path, description, visibility, default branch, topics, and other configuration settings
update_userUpdate an existing user's profile, email, username, password, permissions, and settings, supporting admin modifications or self-service profile updates
update_webhookUpdate an existing webhook's URL, secret token, event triggers, SSL verification, or branch filter for modifying webhook configuration
⌘J