<aside> <img src="/icons/square-three-fourths_gray.svg" alt="/icons/square-three-fourths_gray.svg" width="40px" />

Duplicate this Skill into your workspace so start using it

</aside>

Screenshot 2026-09-30 at 10.54.07 AM.png

Build a complete, one-way GitLab.com → Notion Worker sync for Projects, Issues, Merge Requests, Pipelines, and Releases. Keep all implementation and output requirements in this skill. Do not depend on another Notion page, screenshot, example workspace, or external reference output.

<aside> ⚠️

Critical database-location rule

Create one parent page named GitLab Sync. After deployment creates the five Worker-managed databases, move/reparent the actual database containers to that page. Do not create linked databases, “View of…” wrappers, linked-view substitutes, placeholders, or temporary duplicates. All five managed databases and the Dashboard must report GitLab Sync as their direct parent.

</aside>

Required inputs

All five syncs use replace mode. Never preview or run with an incomplete project list because records from omitted projects can be removed.

Scaffold and inspect

Create a legacy Worker from the local starter. Read the generated Worker instructions, sync guide, authentication guide, pagination guide, replace-paginated example, and installed SDK types before writing code.

Use a concise project name such as gitlab-project-sync. Run all Worker commands from that project directory.

Authentication, configuration, and pacing

Declare a brokered credential so Worker code never reads the raw token:

import { CREDENTIAL_VALUE, Worker } from "@notionhq/workers"
import * as Builder from "@notionhq/workers/builder"
import * as Schema from "@notionhq/workers/schema"

const worker = new Worker()
export default worker

worker.credential("GITLAB_API_TOKEN", {
  network: [{
    domain: "gitlab.com",
    transform: [{ headers: { "PRIVATE-TOKEN": CREDENTIAL_VALUE } }],
  }],
})

const gitlabApi = worker.pacer("gitlabApi", {
  allowedRequests: 8,
  intervalMs: 1000,
})

Call await gitlabApi.wait() immediately before every GitLab request.

Read project selection from GITLAB_PROJECT_IDS, with optional compatibility for GITLAB_PROJECT_ID. Accept comma-separated or newline-separated values. Normalize: