GitLab

The GitLab connector indexes merge requests, issues, and CI pipeline runs into the local SQLite index and exposes a wide read surface across projects, MRs, issues, pipelines, and job traces, plus three HITL-gated write tools.

What’s indexed

Service id: gitlab
Item types: pr, issue, ci_run

Authenticate

nimbus connector auth gitlab

Stored in the Vault as gitlab.pat (and optionally gitlab.api_base_url for self-hosted instances) and injected at spawn as GITLAB_PAT / GITLAB_API_BASE_URL. The MCP server uses the PRIVATE-TOKEN header.

Read tools (no HITL)

Tool	Purpose
`gitlab_issue_get`	Get a single issue by IID.
`gitlab_issue_list`	List issues for a project.
`gitlab_job_log_tail`	Download job trace text, optionally keeping only the last N characters.
`gitlab_job_trace`	Download plain-text trace for a CI job (by job id).
`gitlab_mr_get`	Get a single merge request by IID.
`gitlab_mr_list`	List merge requests for a project.
`gitlab_pipeline_get`	Get a single pipeline by id.
`gitlab_pipeline_jobs_get`	List jobs for a CI pipeline (by pipeline id).
`gitlab_pipeline_list`	List CI pipelines for a project.
`gitlab_project_list`	List projects visible to the authenticated user (membership).

Write tools (HITL-gated)

Every tool below requires interactive consent through the Gateway HITL gate before it executes.

Tool	Purpose
`gitlab_mr_merge`	Merge a merge request.
`gitlab_pipeline_cancel`	Cancel a pipeline.
`gitlab_pipeline_retry`	Retry failed jobs in a pipeline.

Platform notes

For self-hosted GitLab, set gitlab.api_base_url in the Vault (e.g. https://gitlab.example.com/api/v4). Defaults to https://gitlab.com/api/v4.

See also