I am trying to migrate a project from BitBucket to GitHub, and would like to import all the issues (preferably keeping their issue numbers intact).

Is there some tool or service which will accomplish this?

3 Answers 3


This worked for me https://github.com/jeffwidman/bitbucket-issue-migration

python migrate.py -g username -u username -s reponame -d reponame
  • seems to only works for public repos Commented Dec 29, 2013 at 2:40
  • Also fails if you have 2FA enabled.
    – mlissner
    Commented Jul 25, 2014 at 14:32
  • Didn't work even for public repositories
    – Christian
    Commented Dec 15, 2014 at 10:03
  • 1
    i recently took over maintenance of the bitbucket-issue-migration script. I fixed the bugs so it works fine for public repos, private repos are a planned feature in the next few weeks. 2FA is also supported via access tokens--it'll give you a helpful warning message if you try a 2FA account and just provide your normal password. Commented Jan 3, 2016 at 4:07
  • @JeffWidman thank you. Just saw the tool and this. Looking forward to the new release that supports private repo. Commented Jan 15, 2016 at 6:24

I just wrote a simple script in Ruby just to do that, you can check it out here: https://github.com/siong1987/issues_importer

  • It seems, that description of your script is very limited and I think, your code can only be used by an experienced Ruby developer. I found it very usable (the idea) and even thought about installing Ruby just for this one case. However, limited description proven me, that I'm not going to use it, as I have lack of knowledge. Any chance you can extend the description (format of .rb file, what, how and when should be run etc.) or introduce some simple wiki for that repo?
    – trejder
    Commented Sep 21, 2014 at 16:08
  • 1
    @trejder i just updated the documentation. it is actually as easier as that.
    – siong1987
    Commented Sep 22, 2014 at 21:21
  • I'm on Windows and after spending a decent chunk of time trying to get it to run, I'm not sure why running bundle install causes nokogiri (1.6.1) to not get compiled. I see libiconv, libxslt, libxml-2.0 are not found in the mkmf.log file.
    – Adam
    Commented Feb 8, 2017 at 4:54

I found it critical to be able to repeat the migration without causing any havoc. Therefore, I suggest to use this script, which allows to do subsequent tweaks after running the initial issue migration:


Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.