super-productivity/docs/gitlab-access-token-instructions.md

# How to generate a GitLab Access Token with Privileges

## Personal Access Token

For polling GitLab Issues, you need to provide an access token.

1. Go to User Settings / Access tokens
2. Add a new token with the scope `api`

![Personal Token](https://github.com/user-attachments/assets/76fb204e-450a-4516-9d93-897ae2a32f6d)

## Project Access Token
If you self-host GitLab or have the Premium/Ultimate license, it's possible to get a Project Access Token, which is scoped to a project. 
The scope is similar to the Personal Access token, but you also set a role. To learn what each role can do, see the <a href="https://docs.gitlab.com/ee/user/permissions.html#project-planning">Documentation</a>.


![Project Token](https://github.com/user-attachments/assets/f008f114-3d3e-450d-9301-7825222f9812)

For GitHub Personal Access Token instructions, please visit the following link:
[GitHub Access Token Instructions](https://github.com/johannesjo/super-productivity/blob/master/docs/github-access-token-instructions.md)