Connect Claude to GitLab

Find projects by name, path or description, or list the ones you are a member of. Every other action here needs a project_id, and this is where you get it: use either the numeric id or the full path such as gitlab-org/gitlab, both of which this returns. Set membership true to see only projects you belong to, which is usually what you want on a large instance where an unfiltered search returns thousands of public repositories.

Fetch one project: description, default branch, visibility, clone URLs, web URL, topics and which features are enabled. Call it when you need the default branch name for get_file, or to confirm you have the right repository before writing to it. Takes the numeric id or the URL path from list_projects.

List a project's issues with filters for state, labels, milestone, assignee, author and free text. Returns the issue iid - the per-project number shown in the UI as #42 - which every other issue action here takes; the global id in the same response is not interchangeable with it. Use get_issue when you already know the iid and want one issue in full.

Fetch one issue in full: description, state, labels, assignees, milestone, due date, time tracking and web URL. Takes the project-scoped iid from list_issues, not the global id. Use this when you need the actual body; list_issues already carries titles and states.

List a project's merge requests, filtered by state, branch, author, reviewer, labels or free text. Returns each one's iid - the per-project number in the UI - plus title, state, merge status and branches. Use get_merge_request for the description, diff statistics and pipeline of a single one. state defaults to opened, which is what a review queue means.

Fetch one merge request in full: description, source and target branches, merge status, approvals state, head SHA, and the pipeline attached to it. Takes the project-scoped iid from list_merge_requests. Read this before commenting with create_merge_request_note, and take diff_refs.head_sha from here if a later action needs it.

List a project's CI pipelines, newest first, optionally narrowed to one branch, commit SHA or status. Returns each pipeline's id, status, ref, SHA and web URL but nothing about individual jobs - take an id from here and call list_pipeline_jobs to find which job failed. Filter status to failed when you are investigating a broken build.

List the jobs in one pipeline with each job's name, stage, status, duration, runner and web URL. Call list_pipelines first for the pipeline_id. Set scope to failed to go straight to what broke. This returns job metadata, not job logs - open the job's web_url for the trace.

Read one file from a repository at a given branch, tag or commit. GitLab returns the content base64-encoded and it is decoded to text for you, so this is only useful for text files - a binary will come back as mojibake. ref defaults to HEAD, which resolves to the project's default branch. Use list_branches if you need a branch name, and get_project for the default branch.

List a repository's branches with their latest commit, protection status and whether the token's owner can push to each. Filter with search when a project has hundreds. Use it to confirm a branch name before get_file, or to see what work is in flight alongside list_merge_requests.

Return the account this token belongs to: username, name, numeric id, email and whether it is an administrator. Use it to confirm which GitLab identity an agent is acting as, and to get the numeric user id that create_issue's assignee_ids expects. Takes no arguments and changes nothing, which is why it is the install-time health check.

Open a new issue on a project. Only the title is required. Labels are a comma-separated string, and GitLab creates any label that does not already exist, so check list_issues output for the names in use before inventing one. The description is markdown. Returns the created issue including its iid and web URL.

Change an existing issue: retitle it, rewrite the description, reassign it, adjust labels, or close and reopen it with state_event. Send only what you want changed. Prefer add_labels and remove_labels over labels - labels replaces the whole set, and an empty string strips every label. Closing is reversible from here, which is why this is a write rather than a destructive action.

Post a comment on a merge request's main discussion. This is a thread-level note, not a line comment on the diff, and it notifies everyone participating in the review. Get the merge_request_iid from list_merge_requests or get_merge_request first. The body is markdown; GitLab quick actions such as /assign work in it, so keep the text to what you actually mean to say.