Skip to content

GitLab MCP Server — 75 tools

The GitLab DADL turns GitLab's API into an MCP server that Claude, GPT or any MCP-compatible agent can consume directly. One YAML file declares all 75 tools — project, pipeline, group, merge, job, label, and more — and ToolMesh serves them at runtime. No Python boilerplate, no per-endpoint code, no separate MCP server process.

Below: the endpoint coverage matrix, a two-block ToolMesh setup, the full tool reference grouped by GitLab feature area, required credential scopes.

Source: GitLab REST API v4

Credits: Dunkel Cloud GmbHUpdated: 2026-10-10

Which GitLab endpoints are covered?

19% (75 of ~400 endpoints)

Focus: GitLab REST API v4: projects, issues, merge requests, pipelines, jobs, branches, commits, releases, groups, users, repository files, labels, milestones, code search

Missing: deploy tokens, container registry, packages, wikis, snippets, epics, environments, cluster agents, protected branches, webhooks, project hooks

Last reviewed: 2026-10-10

How do you configure the GitLab DADL?

  1. Navigate to GitLab → User Settings → Access Tokens
  2. Enter a name (e.g. 'ToolMesh') and optional expiration date
  3. Select scope: api (full access) or read_api (read-only)
  4. Click 'Create personal access token' and copy the token (starts with glpat-)

Environment variable: CREDENTIAL_GITLAB_TOKEN

Authentication docs ↗

For self-hosted GitLab, replace the URL with your instance address. SaaS users use https://gitlab.com/api/v4

How do you install the GitLab MCP server with ToolMesh?

Add to your backends.yaml:

- name: gitlab
  transport: rest
  dadl: gitlab.dadl
  url: "https://your-gitlab.example.com/api/v4"

Set the credential:

CREDENTIAL_GITLAB_TOKEN=your-token-here

What 75 tools does the GitLab DADL expose?

GETlist_projectsList all visible projects. Use membership=true to limit to projects the user is a member of, owned=true for owned projects.
GETget_projectGet a single project by numeric ID or namespace path with plain slashes (e.g., 'my-group/my-project'). Do not pre-encode slashes as %2F — that 404s.
POSTcreate_projectCreate a new project. Requires name or path.
PUTupdate_projectUpdate a project. Only include fields you want to change.
DELETEdelete_projectDelete a project. Requires owner or admin access.
GETlist_group_projectsList projects in a group. Use include_subgroups to include nested group projects.
GETlist_issuesList all issues visible to the authenticated user. Use scope to filter by created_by_me, assigned_to_me, or all.
GETlist_project_issuesList issues for a specific project.
GETlist_group_issuesList issues for a group.
GETget_project_issueGet a single project issue by its internal ID (iid).
POSTcreate_issueCreate a new issue in a project.
PUTupdate_issueUpdate an issue. Use state_event 'close' or 'reopen' to change state. At least one field required.
DELETEdelete_issueDelete a project issue. Requires Planner/Owner role or issue author (GitLab 18.10+).
GETlist_merge_requestsList all merge requests visible to the authenticated user. Date filters (created_after/created_before, updated_after/updated_before) take ISO 8601 datetimes and are inclusive. state defaults to "opened" here -- pass state "all" when computing a delta that must include merged or closed MRs. Returns one page (page/per_page).
GETlist_project_merge_requestsList merge requests for a specific project. For delta/sync queries use the date filters instead of paging through everything: created_after/created_before, updated_after/updated_before (ISO 8601 datetimes, e.g. "2026-03-15T08:00:00Z", inclusive). state defaults to "opened" here -- pass state "all" when the delta must include merged or closed MRs. Returns one page (page/per_page, max 100).
GETlist_group_merge_requestsList merge requests for a group (all its projects). Same date filters as list_project_merge_requests: created_after/created_before, updated_after/updated_before (ISO 8601, inclusive). state defaults to "opened" here -- pass state "all" for deltas over merged or closed MRs. Returns one page.
GETget_merge_requestGet a single merge request by its internal ID.
POSTcreate_merge_requestCreate a new merge request. source_branch and target_branch must be different. Duplicate source/target pairs are rejected.
PUTupdate_merge_requestUpdate a merge request. Use state_event 'close' or 'reopen' to change state.
PUTmerge_merge_requestAccept and merge a merge request. Optionally squash commits or set a custom merge commit message.
POSTapprove_merge_requestApprove a merge request. Optionally verify HEAD SHA to ensure reviewing the correct version.
PUTrebase_merge_requestRebase a merge request's source branch onto the target branch.
GETlist_branchesList repository branches. Use search for substring matching or regex for pattern matching.
GETget_branchGet a single branch including its latest commit and protection status.
POSTcreate_branchCreate a new branch from a ref (branch name, tag, or commit SHA).
DELETEdelete_branchDelete a branch. Cannot delete the default or protected branches.
DELETEdelete_merged_branchesDelete all branches that have been merged into the default branch. Returns 202 Accepted.
GETlist_commitsList commits in a repository. Filter by branch/tag (ref_name), file path, author, or date range.
GETget_commitGet a single commit by SHA, branch name, or tag name. Includes author info, message, and parent SHAs.
GETget_commit_diffGet the diff of a commit showing file changes with unified diff content.
GETlist_pipelinesList pipelines for a project. Child pipelines are not included by default.
GETget_pipelineGet a single pipeline by ID.
GETget_latest_pipelineGet the latest pipeline for a ref. Defaults to the default branch.
POSTcreate_pipelineTrigger a new pipeline on a branch or tag. Note: singular 'pipeline' in path, not 'pipelines'.
POSTretry_pipelineRetry all failed jobs in a pipeline.
POSTcancel_pipelineCancel a running pipeline and all its running jobs.
DELETEdelete_pipelineDelete a pipeline. Deletes builds, logs, artifacts, and triggers. Cannot be undone.
GETget_pipeline_variablesGet variables for a pipeline.
GETget_pipeline_test_reportGet the test report for a pipeline.
GETlist_project_jobsList jobs for a project. Supports both offset and keyset pagination.
GETlist_pipeline_jobsList jobs for a pipeline. Retried jobs are excluded by default; use include_retried=true to include them.
GETget_jobGet a single job by ID.
GETget_job_logGet the log (trace) output of a job. Returns plain text, not JSON.
POSTretry_jobRetry a single job.
POSTcancel_jobCancel a running or pending job.
POSTplay_jobTrigger a manual job.
GETlist_releasesList releases for a project, sorted by released_at descending.
GETget_releaseGet a single release by its associated tag name.
POSTcreate_releaseCreate a release. If the tag does not exist, ref is required to create it.
PUTupdate_releaseUpdate a release. Only name, description, milestones, and released_at can be changed.
DELETEdelete_releaseDelete a release. The associated Git tag is preserved. Requires Maintainer access.
GETlist_groupsList visible groups. Without authentication, only public groups are returned.
GETget_groupGet details of a group by numeric ID or full path with plain slashes (e.g. 'parent-group/subgroup').
GETlist_subgroupsList direct subgroups of a group.
POSTcreate_groupCreate a new group. Requires name and path.
GETget_current_userGet the currently authenticated user's profile.
GETlist_usersList all users. Admins see extended fields. Use search to find by name, username, or email.
GETget_userGet a single user by numeric user ID. Admins see extended fields including sign-in history.
GETget_fileGet file metadata and base64-encoded content. Pass file_path with plain slashes (e.g. 'config/rules/hosts.yml'); do not pre-encode them as %2F.
GETget_file_rawGet raw (unencoded) file content. Returns the file directly, not JSON.
POSTcreate_fileCreate a new file in the repository. Creates a commit.
PUTupdate_fileUpdate an existing file in the repository. Creates a commit.
DELETEdelete_fileDelete a file from the repository. Creates a commit.
GETlist_labelsList all labels for a project.
GETget_labelGet a single label by ID or title.
POSTcreate_labelCreate a new label. Color must be a 6-digit hex with '#' prefix (e.g., '#FF0000') or a CSS color name.
PUTupdate_labelUpdate a label. At least new_name or color is required.
DELETEdelete_labelDelete a label from the project.
GETlist_milestonesList all milestones for a project.
GETget_milestoneGet a single milestone by ID.
POSTcreate_milestoneCreate a new milestone. Dates use YYYY-MM-DD format.
PUTupdate_milestoneUpdate a milestone. Use state_event 'close' or 'activate' to change state.
GETsearch_globalSearch across the entire GitLab instance. Scope determines what to search: projects, issues, merge_requests, milestones, snippet_titles, users, wiki_blobs, commits, blobs, notes.
GETsearch_groupSearch within a group. Same scopes as global search.
GETsearch_projectSearch within a project. Scopes: issues, merge_requests, milestones, users, wiki_blobs, commits, blobs, notes. Use ref to search a specific branch/tag.