Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Sourcetree for Mac GitHub account permissions

Boris Perović December 12, 2018

When adding a GitHub account to Sourcetree for Mac 3.0.1 (205), using OAuth and HTTPS, only public read permissions are requested:


Consequently, no private repos are accessible and no write permissions are given. I found no way of elevating the requested permissions either through Sourcetree or through GitHub settings.

I found a workaround by accident: after the Sourcetree app is authorized, an entry is created in Keychain Access:

Github Credentials
Kind: application password
Where: SourceTree (OAuth) for GitHub

Deleting this entry, relaunching Sourcetree and clicking on "Remote" tab gives this info:


After clicking on "Sign In", GitHub finally presents the additional permissions prompt:


Shouldn't Sourcetree ask for all of these permissions when adding the account using the normal workflow?

Thank you.

14 answers

48 votes
Boris Perović December 28, 2018

Still when using the workaround I proposed, I am unable to access private repos of some organizations I am a part of, rather I need to request access individually for SourcetreeForMac from here like this:

Screen Shot 2018-12-28 at 7.04.32 PM.png

Searching around, I found another workaround, which finally gave me the full access:

1) Go to
2) Click "Generate new token"
3) Input token description e.g. "Sourcetree Mac Token", select "repo" checkbox, and click "Generate token"
4) Copy the generated token
5) Add your GitHub account to Sourcetree, but now rather than using OAuth, select Basic authentication
6) Input your username
7) Paste the generated token as password

Now you should have a fully functional connection between your GitHub account and Sourcetree, including access to all private repos. If you encounter any functionality that is not working (I haven't), try regenerating the token with more permissions - I intentionally selected only "repo", as that is all I need at this moment.

Hope this is helpful, until there is a fix from Sourcetree team. As mentioned above, the issue has already been filed here


Jingran Wang December 28, 2018

For Windows, you need to also select the "user" checkbox while generating the token, otherwise it won't work. (for anyone that finds this from searching Google)

Like Vevek Selvam likes this
NawalJAhmed May 2, 2020

Thank you, your workaround fixed my issue. Still cannot believe this still persists in May 2020.

Juuso Takalainen August 21, 2020

Worked for me, too. Mostly straightforward (in retrospect), only gotcha really is pasting the generated token into "Password" field. They probably should rename it to "Token" or something.

Bhardwaj Pandya September 6, 2020

this worked like a charm, many thanks,

Michael Scullin January 10, 2021

Solved, thanks Boris

furey March 27, 2021

Worked for me—thanks @Boris Perović! 🎉

Vladimir Tormoz March 29, 2021

This workaround helped!

0cddo April 22, 2021

Thanks!!! you saved me!!

Mhd_Denno July 5, 2021

Thanks a lot it works :)

Lucas Guardado July 28, 2021

Thanks a lot!!!!

Remi October 25, 2021

Still working in October 2021. Thanks @Boris Perović !

Simon van Stipriaan November 23, 2021

Thanks @Boris Perović

ingvictoriano December 21, 2021

Still happening December 2021! Thanks! @Boris Perović 

Anatoly Rudenko February 9, 2022

February 2022....

zeki şahbaz February 12, 2022

thanks a lot @Boris Perović  still working

Sanmi February 27, 2022

@Boris Perović Thanks. This worked like magic.

rezki March 13, 2022

@Boris Perović thank you so much, 14 march and it helped me :) 

bakerjw March 14, 2022

This was a huge help--thank you!

oelbaganwg May 17, 2022

Thank you!!! Beens searching for days. This was the ONLY solution. 

Ramiro Martinez May 24, 2022

It worked, thank you!!

repentsinner June 10, 2022

Thanks much! So frustrating (though I suppose par for the course for an Atlassian product). Still useful as of SourcetreeForMac 4.1.8.

TKOxff July 2, 2022

Thanks you! It is still working well.

Sebastian Echeverry August 5, 2022

this is not working for me

marta.gilberti September 20, 2022

It worked for me, thanks so much Boris!

Eymen Varilci September 26, 2022

this one worked for me as well. Cheers mate!

Like Filip Makaroni likes this
Filip Makaroni December 17, 2022

Thanks a lot Boris, I can't believe OAuth isn't fixed yet

3 votes
Volodymyr April 17, 2020

This should be FIXED! 

Using macOS app 4.0.1(234) still has this bug! 

2 votes
tstampfel November 1, 2021

This worked for me without hacks.

1. Choose Basic auth 

2. Input github username.

3. Choose SSH protocol (should be default) and then click on "Generate key"

4. In your github.  Settings > SSH and GPG keys > New SSH Key -  paste generated key.

5. Then Settings > Personal access tokens > Generate new token.

6. Add your self enough rights that you feel comfortable with and set proper expiration.

7. After generating PAT paste it in SourceTree in password field. 


Voila now you have access to private repo and rights that you choose under PAT.

2 votes
Sven Schmid November 26, 2020

This is still not solved right?
GitHub constantly informs me that Basic Authentication will soon no longer be available:

(Basic authentication using a password to the API is deprecated and will soon no longer work. Visit for more information around suggested workarounds and removal dates.)


Guess, its time to leave Sourcetree behind!

0 votes
Da Ju August 23, 2021

Wow, 3 years later and this stupid work-around is still needed.

Thank you Boris!! Worked exactly as you said. (Github with SSH.)

Shame on you Atlassian.

0 votes
rufwork May 14, 2021

I've painfully downloaded GitHub Desktop for macOS and use it to do my pushes to origin. I guess if I were a "real dev" I'd set up the command line instead, but didn't want to mess with setting up a PAT again and GitHub Desktop, though not quite as nice as SourceTree, does wisely ask for push permissions (and stores the results) on first login.

0 votes
larndicus March 18, 2021

This is absurd... but it works.


Thank you!

0 votes
Terrance January 18, 2021

To Sourcetree staff:

Problem still exists - I imagine getting your competitor's repos to work easily with your software seems counter-intuitive, however this problem was just about to drive me to start using the Github application instead...soo.....

Food for thought.

To the OP:


THANK YOU for this post, this solved it for me on Mac.


0 votes
Charles Moreno December 21, 2020

Spent couple of hours figuring this out. Tried everything that I can find but unfortunately nothing works. Not unless I found this, thank you! This works perfectly for my case!



0 votes
Israel_Ocbina March 7, 2020

Screen Shot 2020-03-08 at 12.40.10 PM.png


I was so disappointed because until now I can't find solution to this. Sourcetree has no support yet for private data viewing or to access it from Github. Only Public Data is viewable. Please any help thanks.

Charles Gugino March 7, 2020

Read the part about the workaround in the first post, and try that

0 votes
Tom Smith December 17, 2019

This works properly in the Windows version of SourceTree but (still, one year later) is not fixed in the Mac version as of 4.0.232.  There were a handful of other bugs in the authorization dialog too (such as, can't switch from Basic to OAuth on an existing account).  Anyone driving this bus?

The workaround at the top with deleting the keychain entry does work, so some part of the SourceTree code has the right implementation for requesting permissions.  So the response from the Atlassian Team member to the effect of "we do this on purpose" can be ignored.

0 votes
ShaneBharadwaj May 28, 2019

Hi Boris,

Thank you so much for the solution. This worked for my organizations private repo. Strangely, none of my colleagues faced the issue except me. We have 2FA enabled and only for me it was causing issue.

Just to mention, am in Mojave while all my colleagues are still in High Sierra but don't think this should be an issue.



0 votes
Onur Var December 17, 2018

Hi Boris,

First of all thanks for the workaround. I was able to access my private repositories with your approach. 

I think this problem is bigger than it seems, because if you're new to GitHub (or any other alternatives) and SourceTree, you may end up losing your access to your private repositories. The reasons why so many people are not facing this problem are either this problem is something new (maybe related with 3.0.1) or they have already given the permission to SourceTree for full access. I was revoking my Oauth App tokens and when I re-connect my GitHub account with SourceTree, I face this one. 

Hope you guys figure this out soon.

0 votes
Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
December 14, 2018

Hi Boris,

Sourcetree's OAuth permissions for all services (not just GitHub) are intentionally narrowly scoped. We don't want authorization for actions we aren't using in the app. The request for private repos is a good one and should be filed in our public trackers (Mac and Windows) Cheers!

Brian Ganninger
Senior Mac Developer, Sourcetree

Boris Perović December 17, 2018

Hi Brian,

Thank you for answering. I do appreciate the privacy-conscious approach that the Source Tree team is taking. Still, the basic set of public read permissions requested does not even allow for write access to public repos, so I am unable to push any changes. It seems that someone has already filed an issue regarding this behavior:

Hope this gets sorted out soon.

Kind regards

kevinfoley August 19, 2019

@bgannin  Brian, eight months later, your team still has not fixed this issue that makes SourceTree unusable on Macs.

Atlassian Team
Atlassian Team members are employees working across the company in a wide variety of roles.
August 28, 2019

We are investigating currently.

Marcelo Catach November 21, 2019

That's ridiculous. I can't access my private repository because of the "actions you are not using in the app"? It seems you like to make source tree unusable.

To continue like that it's better to stop developing it. You need to decide if you want to create a useful tool or some sort of a gimmick.

Suggest an answer

Log in or Sign up to answer
AUG Leaders

Atlassian Community Events