Returns the authenticated user, the configured GitLab instance URL and the instance version. Use this first to verify GITLAB_URL/GITLAB_TOKEN are wired correctly.

Global, group or project search across projects, issues, merge requests, code blobs, commits, wiki and notes.

Lists the authenticated user's todo items (assignments, mentions, review requests).

Marks a single todo as done, or all pending todos when todo_id is omitted.

Activity stream for the current user or a project (pushes, comments, merges, ...).

Searches instance users by username or free text.

Fetches a single user by id.

Renders markdown through GitLab so relative upload links and issue references are expanded to absolute URLs — handy before downloading attachments.

Escape hatch that calls ANY GitLab REST API v4 endpoint with the configured credentials. Use it for endpoints without a dedicated tool (epics, packages, feature flags, admin, custom instance routes). See https://docs.gitlab.com/ee/api/api_resources.html

Lists projects visible to the token, with search and membership filters.

Full details for one project, including default branch, namespace and web URL.

Creates a new project, optionally inside a group.

Edits project settings.

Deletes (or schedules deletion of) a project. Irreversible on most instances.

Forks a project into a namespace.

Members of a project, optionally including inherited group members.

Grants a user access to a project.

Lists groups visible to the token.

Details for one group.

Projects inside a group, optionally recursing into subgroups.

Members of a group.

Lists issues for a project, a group, or the whole instance (omit project_id and group_id) with the usual filters.

Full issue: description, labels, assignees, milestone, plus (by default) every comment and the URLs of every attached screenshot/file. Feed those URLs to gitlab_read_attachment to actually view the images.

Creates an issue in a project.

Edits an issue, including closing/reopening it.

Permanently deletes an issue.

Lists comments (notes) on an issue, merge request, snippet or epic.

Posts a comment on an issue, merge request, snippet, epic or commit. Embed uploaded screenshots with the markdown returned by gitlab_upload_file.

Edits an existing comment.

Threaded discussions, including code-review threads with their file/line position and resolved state.

Adds a reply to an existing discussion thread.

Lists, creates or removes links between issues (relates to / blocks / blocked by).

Reads or updates estimate and spent time on an issue.

Merge requests that reference or close this issue.

Labels of a project or group.

Creates a project label.

Milestones of a project or group.

Issue boards and their lists for a project or group.

Lists merge requests for a project, a group, or the whole instance (omit both ids) with the usual filters.

Full merge request: branches, approvals, merge status, pipeline, plus optional comments and attachment/screenshot URLs.

The actual code changes of a merge request, file by file. Truncated to stay readable.

Opens a merge request between two branches.

Edits a merge request.

Merges a merge request, optionally waiting for the pipeline to pass.

Approve/unapprove, rebase, cancel auto-merge, or inspect approvals, commits, participants, closed issues and pipelines of a merge request.

Starts a review thread. With file_path + line + diff_refs it anchors to a specific line; without them it posts a general discussion. Get diff_refs from gitlab_get_merge_request.

Marks a review thread resolved or unresolved.

Lists files and directories in the repository tree.

Reads a file from the repository. Text comes back decoded; set as_image=true to look at an image committed to the repo.

Creates or updates a single file in a branch.

Creates one commit that touches several files at once (create/update/delete/move).

Branches of a project.

Gets, creates or deletes branches.

Commit history with optional path and date filters.

One commit with stats and optionally its diff.

Diff between two branches, tags or commits, including the commit list.

Repository tags.

Creates or deletes a tag.

Releases of a project.

Publishes a release for a tag.

Protection rules for branches (who may push/merge).

Per-line authorship for a file.

CI pipelines with status and ref filters.

A pipeline with its jobs, durations and failure reasons.

Triggers a new pipeline, or retries/cancels/deletes an existing one.

Jobs of a pipeline or of the whole project.

Downloads the trace/log of a CI job — the fastest way to find out why a pipeline failed. Returns the tail by default.

Inspects, retries, cancels, runs or erases a CI job.

Downloads a CI artifact. A single image path (Playwright/Cypress screenshot, coverage badge) comes back as a viewable image.

Manages project CI/CD variables. Values of masked variables are not returned by GitLab.

Validates CI configuration against the project's context before committing it.

Deployment environments of a project.

Deployment history of a project.

Scheduled pipelines of a project.

Downloads an attached file from GitLab with authentication and returns it. PNG/JPEG/GIF/WebP images come back as viewable images, text files as text, anything else as a base64 resource. This is how you look at screenshots pasted into issues, merge requests and comments.

Scans the description and comments of an issue, merge request or epic and returns every attached file/screenshot with a ready-to-use URL for gitlab_read_attachment.

Uploads a local file to the project's upload store and returns the markdown snippet to embed it in an issue, MR or comment.

Authenticated GET of an arbitrary URL on the GitLab instance — job artifacts, raw files, avatars, design files. Returns images as images and text as text.

Lists, reads and edits wiki pages of a project.

Manages project snippets, including raw content.

Lists, creates and deletes project webhooks.

Packages published to the project registry.

Container registry repositories of a project, optionally with tags.

Lists, adds or removes emoji reactions.

Languages, contributors and repository size for a project.