GitLab Tools

Interact with GitLab to list and inspect projects, manage issues, and read repository files. Use these tools in workflows that automate software development lifecycle operations — triaging bugs, auditing repositories, or syncing project data.

Overview

Operations

Configuration

gitlab_list_projects

gitlab_get_project

gitlab_list_issues

gitlab_create_issue

gitlab_get_file

Outputs

gitlab_list_projects

• data (json) — Array of GitLab project objects returned by the API
• metadata (json) — List metadata
  • metadata.count (number) — Number of projects returned

gitlab_get_project

• data (json) — The GitLab project object
• metadata (json) — Project identifiers
  • metadata.id (number) — Project ID

gitlab_list_issues

• data (json) — Array of GitLab issue objects
• metadata (json) — List metadata
  • metadata.count (number) — Number of issues returned

gitlab_create_issue

• data (json) — The created GitLab issue object
• metadata (json) — Issue identifiers
  • metadata.id (number) — Issue ID

gitlab_get_file

• data (json) — The GitLab file object, including base64-encoded content in the content field
• metadata (json) — File identifiers
  • metadata.id (string) — File path or blob ID

YAML Example

gitlab_1:
  type: gitlab
  name: "GitLab"
  inputs:
    operation: "gitlab_create_issue"
    projectId: "myorg/myproject"
    title: "{{agent_1.output}}"
    description: "Automatically created by workflow."
    labels: "bug,auto"
    apiKey: "{{GITLAB_API_KEY}}"
  connections:
    outgoing:
      - target: next-block-id

Tips

• Generate a Personal Access Token at GitLab > User Settings > Access Tokens. Grant at minimum the api scope for full read/write access, or read_api for read-only operations.
• projectId accepts either a numeric ID (e.g., 12345) or a URL-encoded namespace/path (e.g., myorg/myrepo). Both forms are supported across all tools.
• File content returned by gitlab_get_file is base64-encoded in the data.content field. Use a Function block with atob({{gitlab_1.data.content}}) to decode it to plain text before passing it to an Agent block.