> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trynota.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# GitLab

> Provide a GitLab personal access token and project ID so Nota can interact with your repo.

# 🦊 GitLab (team feature)

Connect GitLab with a personal access token and the project ID you want Nota to use. On the Integrations page, use the GitLab card: **Configure** to set up, **Update** to edit.

<img src="https://mintcdn.com/notaai/1x5ZOEq8LGaWrXEp/images/integrations-gitlab.png?fit=max&auto=format&n=1x5ZOEq8LGaWrXEp&q=85&s=0bf8f9b19b212ff179eb8f4530cd84ea" alt="Placeholder: GitLab token settings" width="1" height="1" data-path="images/integrations-gitlab.png" />

## What you need

* **GitLab Access Token** with at least `api` scope
* **GitLab Project ID** for the repository Nota should access
* Admin/team-level access to **Integrations → GitLab**

## Create a GitLab access token

1. In GitLab, open **User → Edit profile → Access Tokens** (sometimes shown as **User settings → Personal Access Tokens**).
2. Click **Create personal access token**.
3. Set a **Name** (e.g., “Nota Bot”), an **Expiration date**, and select the **api** scope (minimum for API access).
4. Click **Create personal access token**, then copy the token shown once.
5. Store it securely—GitLab will not show it again.

## Find your project ID

1. Open the target project in GitLab.
2. In the project home sidebar, look for **Project information → Details**. The **Project ID** appears in the right column.
3. Alternatively, check the URL: `https://gitlab.com/<group>/<project>/-/settings` often shows `?project_id=<id>` in the query string.

## Add credentials in Nota

1. Open **Integrations** in the left nav and select the **GitLab** card.
2. Enter the **GitLab Access Token** you created.
3. Enter the **GitLab Project ID** for the target repo.
4. Save. Nota will use these values immediately—no environment variable or redeploy needed.

> 🔐 Use short-lived tokens when possible, and rotate the token if you move repositories or change scopes.