GitLab MCP server for AI agents

Projects, issues, merge requests, pipelines, branches and files on GitLab.

Auth
OAuth 2.0 (sign in with the app) · Access token
Tools
14
Triggers
0
Category
Developer tools
Connect GitLab gitlab.com

Tools and triggers

  • Get the current user

    GITLAB_GET_CURRENT_USER

    Returns the GitLab user the token belongs to.read-only

  • List projects

    GITLAB_LIST_PROJECTS

    Lists projects the user is a member of, most recently active first. Set `membership` to false to search all visible projects.read-only

  • Get a project

    GITLAB_GET_PROJECT

    Returns a project's details: description, default branch, visibility, URLs and open issue count.read-only

  • List issues

    GITLAB_LIST_ISSUES

    Lists issues in a project, newest first.read-only

  • Create an issue

    GITLAB_CREATE_ISSUE

    Opens a new issue in a project.

  • Update an issue

    GITLAB_UPDATE_ISSUE

    Changes an issue's title, text, labels or assignees. Use `state_event` `close` or `reopen` to change its state.destructive

  • Comment on an issue

    GITLAB_ADD_ISSUE_NOTE

    Adds a comment (note) to an issue.

  • List merge requests

    GITLAB_LIST_MERGE_REQUESTS

    Lists merge requests in a project, newest first.read-only

  • Get a merge request

    GITLAB_GET_MERGE_REQUEST

    Returns one merge request: title, description, branches, state, merge status and author.read-only

  • Create a merge request

    GITLAB_CREATE_MERGE_REQUEST

    Opens a merge request from one branch into another.

  • Comment on a merge request

    GITLAB_ADD_MERGE_REQUEST_NOTE

    Adds a comment (note) to a merge request.

  • List pipelines

    GITLAB_LIST_PIPELINES

    Lists CI/CD pipelines of a project, newest first. Filter by status or branch.read-only

  • List branches

    GITLAB_LIST_BRANCHES

    Lists the branches of a project's repository.read-only

  • Get file contents

    GITLAB_GET_FILE

    Reads a file from a project's repository and returns its text. Uses the default branch when `ref` is left out.read-only

Connect via MCP

Create an MCP server for GitLab in the dashboard, then add its URL to your client. This is the Claude Code command; the client guide has the others.

terminal
claude mcp add --transport http gitlab \
  "https://www.prompt-tm.com/mcp/<server id>?user_id=<your user>" \
  --header "x-api-key: ptm_…"

Connect via REST

Run a tool with one request. The response is { data, error, successful, log_id } for every tool.

terminal
curl -X POST https://www.prompt-tm.com/api/v3/tools/execute/GITLAB_GET_CURRENT_USER \
  -H "x-api-key: $PROMPT_TM_KEY" -H "content-type: application/json" \
  -d '{ "user_id": "alice", "arguments": {} }'

GitLab questions

Other toolkits