Skip to main content

Synchronized Gitlab Issues into Microsoft Project

Project description

Build Status PyPi Version PyPi Downloads Python Versions Wheel Build Project Status Code Style Black Checked with mypy pre-commit License: MIT Documentation Status Average time to resolve an issue Percentage of issues still open


Sync Gitlab Issues into a Microsoft Project File. Use it if you use MS Project for the general project planning but want to keep the Issues in Gitlab as a part of your project planning to follow the process progess.

Currently only Information from Gitlab Issues are inserted and updated within the Project File. Changes in synchronised fields will be overwritten.

The following MS Project attributes are synced (overwritten) from gitlab:

  • Name
  • Notes (from Description)
  • Deadline (from Due Date)
  • Work (from Time Estimated)
  • Actual Work (from Time Spent)
  • Percent Complete (if Tasks given for issue, otherwise only 0% and 100% [for closed])
  • Text28 (the list of labels)
  • Text29 (the URL to gitlab issue)
  • Text30 (the reference to the issue is stored there)
  • Hyperlink (link/URL to gitlab issue)

Not yet implemented but planned:

  • Resources (from Assigned)

Moved issues will be handled if the group selected and the issue was moved within the group. Problem is that accessing issues only by ID is just allowed for admins.


This project runs only in an Windows Environment with Microsoft Project installed.

Please note: This Script has been tested only mit Microsoft Project 2016. It cloud be, that some of the API has changed in newer versions. If you run into any troubles with a new version, please open an Issue.


usage: sync_gitlab2msproject [-h] [--version] [-v] [-vv] [--gitlab-url GITLAB_URL] [--gitlab-token GITLAB_TOKEN] {project,group} gitlab_resource_id project_file

Sync Gitlab Issue into MS Project

positional arguments:
  {project,group}       Gitlab resource type to sync with
  gitlab_resource_id    Gitlab resource id to sync with
  project_file          Microsoft Project File to sync with

optional arguments:
  -h, --help            show this help message and exit
  --version             show program's version number and exit
  -v, --verbose         set loglevel to INFO
  -vv, --very-verbose   set loglevel to DEBUG
  --gitlab-url GITLAB_URL
                        URL to the gitlab instance i.e.
  --gitlab-token GITLAB_TOKEN
                        Gitlab personal access token


  1. Optional: Install pipx
  2. Install the package pipx install SyncGitlab2MSProject (or use pip if you don't like pipx)
  3. Push the gitlab Issue to your MS Project file: sync_gitlab2msproject --gitlab-url --gitlab-token <your_token> group <your_group_id> ms_project_file.mpp

Open Hyplerlink Problems

If you have troubles that the wrong issues are opened once you click on a Hyperlink use the following VBA Script as a workaround. Simply add the VBA script to your Ribbon and it will open all Hyperlinks of the selected tasks.

Option Explicit

Private Declare Function ShellExecute _
  Lib "shell32.dll" Alias "ShellExecuteA" ( _
  ByVal hWnd As Long, _
  ByVal Operation As String, _
  ByVal Filename As String, _
  Optional ByVal Parameters As String, _
  Optional ByVal Directory As String, _
  Optional ByVal WindowStyle As Long = vbMinimizedFocus _
  ) As Long

Public Sub OpenUrls()

    Dim lSuccess As Long
    Dim T As Task
    Dim Names As String
    For Each T In ActiveSelection.Tasks
        lSuccess = ShellExecute(0, "Open", T.HyperlinkAddress)
    Next T
End Sub


This project has been set up using PyScaffold 3.2.3. For details and usage information on PyScaffold see

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for SyncGitlab2MSProject, version 0.0.6
Filename, size File type Python version Upload date Hashes
Filename, size SyncGitlab2MSProject-0.0.6-py2.py3-none-any.whl (20.4 kB) File type Wheel Python version py2.py3 Upload date Hashes View
Filename, size SyncGitlab2MSProject-0.0.6.tar.gz (60.5 kB) File type Source Python version None Upload date Hashes View

Supported by

AWS AWS Cloud computing Datadog Datadog Monitoring DigiCert DigiCert EV certificate Facebook / Instagram Facebook / Instagram PSF Sponsor Fastly Fastly CDN Google Google Object Storage and Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Salesforce Salesforce PSF Sponsor Sentry Sentry Error logging StatusPage StatusPage Status page