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
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
How do you configure the GitLab DADL?
- Navigate to GitLab → User Settings → Access Tokens
- Enter a name (e.g. 'ToolMesh') and optional expiration date
- Select scope: api (full access) or read_api (read-only)
- Click 'Create personal access token' and copy the token (starts with glpat-)
Environment variable: CREDENTIAL_GITLAB_TOKEN
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-hereWhat 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.