Notion AI connector for GitHub

To connect GitHub to your Notion workspace:

1. In Notion, open Notion AI at the bottom of your screen and click on ••• → Connect GitHub. You can also go to Settings → Connections → the Workspace tab and click Connect under GitHub. You'll be taken to GitHub. Don't close Notion during the setup process!

   

2. In the page that opens, connect to GitHub and select the organization you want to sync.

3. Select All repositories (recommended) or Select repositories, then select Install.

   

Once the integration is set up, it will be able to index PRs and issues going back a year from when the setup is complete. You’ll also have access to all code files including markdown files and READMes with no time restrictions.

It can take up to 72 hours for the connection to complete. Afterwards, each user in your Notion workspace must authenticate with GitHub individually to use the integration, and their permissions will be mapped accordingly.

If you aren’t the owner of your Notion workspace or your GitHub organization, you’ll need an owner to connect Notion with GitHub first before you can use the integration. Once the integration has been set up by an owner, you’ll have to log in to connect your private repositories. To do this:

1. In Notion, open Notion AI at the bottom of your screen and click on ••• → Connect GitHub.

2. Select Log In and connect your GitHub account.

I connected the wrong Notion workspace. How can I disconnect my Github Repository?

Workspace owners may disconnect or edit channels after the initial integration is complete by opening Notion AI at the bottom of their screen and clicking on ••• → Connect GitHub → Settings → Edit repositories or Disconnect.

How long does it take for the integration to complete?

Setting up the integration can take up to 72 hours depending on the size of the repository and GitHub plan type.

How long does it take for new content in GitHub to be reflected in Notion AI?

After the initial setup, we will index new data every 30 minutes.

Can I limit the scope of my Notion AI search to just GitHub?

Yes! Open Notion AI at the bottom of your screen and before entering your query, open the dropdown next to your query (it’ll say All by default). Select GitHub in the menu that appears.

Can everyone in my Notion workspace access information from GitHub?

Members in a workspace will initially only have access to retrieve information from public repositories. Members must authenticate and log in individually to retrieve information from private repositories that they already have access to in GitHub.

How far back can I ask questions about in GitHub?

You can retrieve up to one year’s worth of PRs and issues in their repository. All READMes will be available without any time restrictions.

Do Notion AI connectors respect existing Notion AI permissions?

Absolutely. Notion AI will honor existing permissions according to our existing Notion AI Security Practices. Users will not be able to generate content or receive Notion AI responses based on third-party resources they do not have access to.

How does Notion AI handle permissions mapping?

Notion AI for GitHub maps GitHub members to Notion members. The user must be both a GitHub and Notion member to authenticate this app at the user level. We sync permissions from GitHub every hour and update permissions in Notion accordingly.

How is Notion storing or referencing my GitHub data in its systems?

Similar to our core Notion AI product, we store create and store embeddings in a vector database hosted by Pinecone, which powers the ability to provide responses to questions that leverage third party content (e.g., GitHub). Pinecone has been vetted by our security team as well as an external auditor to obtain their SOC2 Type II certification. Learn more about Pinecone’s security here →