🦊

GitLab

Available

Integrate GitLab with tapioca for seamless development workflow. Link merge requests, issues, and CI/CD pipelines to your tasks.

What you can do

Link merge requests to tasks

Import GitLab Issues as tapioca tasks

Track CI/CD pipeline status per task

Automatic status updates from MR events

Two-way issue synchronization

Branch references in task descriptions

Time tracking sync with GitLab

In GitLab, go to Settings → Access Tokens and create a token with api, read_repository, and read_user scopes.

Navigate to Settings → Integrations → GitLab and enter your GitLab URL and access token.

tapioca will automatically configure webhooks for your selected projects, or you can set them up manually.

Link GitLab projects to tapioca projects for automatic issue and MR association.

Option	Type	Required	Description
gitlab_url	string	Yes	GitLab instance URL (gitlab.com or self-hosted)
access_token	string	Yes	GitLab access token with required scopes
project_mapping	object	No	Map GitLab projects to tapioca projects
auto_link_commits	boolean	No	Auto-link commits mentioning task IDs Default: `true`
import_issues	boolean	No	Import GitLab Issues as tasks Default: `false`
sync_time_tracking	boolean	No	Sync time tracking between platforms Default: `false`

Cannot connect to self-hosted GitLab

Ensure your GitLab instance is accessible from tapioca's servers. Check firewall rules and SSL certificates.

Webhooks not working

Verify the webhook URL is correctly configured in GitLab and the secret token matches.

Merge requests not linking

Include the task ID in MR title or description (e.g., "Resolves TAP-123").

Our team is here to help you get set up and running.