Notion AI connector for GitHub

To connect GitHub to Notion AI:

• You must be a GitHub organization owner and Notion workspace owner.

• Your workspace must be on the Business or Enterprise Plan and have more than one member.

Once the connection is made, members of your Notion workspace must log in to access the repositories that they have access to.

To connect GitHub to your Notion workspace:

1. Go to Settings → Notion AI.

2. Select + next to GitHub.

   

3. You'll be taken to GitHub. Make sure you're logged in with the correct GitHub account. Don't close Notion during the setup process!

   

4. In the page that opens, connect to GitHub and select the organization you want to sync. Note that if you want to connect a personal GitHub repository, you must first create an organization and then move the repository into the organization.

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

6. Return to Notion.

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.

Each user will only be able to use Notion AI to see and search content that they have access to in GitHub. Notion AI can retrieve the past year's worth of information from PRs.

The GitHub AI connector is most helpful for:

• Asking about recent changes and project updates.

• Finding code implementations.

• Looking up issues and their status.

• Debugging issues. For example, you can get context when features are broken or throwing errors by reading through recent PRs.

• Finding security patterns.

You could try prompting Notion AI with the following:

• "What's the latest with {project name}?"

• "Which pull requests did we work on over the past week?"

• "What are the recent changes to our authentication system?"

• "Show me examples of how we're implementing error handling in our codebase."

• "What are the main dependencies used in our frontend components?"

• "Find implementations of the database migration functions."

• "What security patterns are we using for API endpoints?”

You can search GitHub via Notion AI connectors in the following places:

• The Notion AI chat in the bottom right of Notion.

• The Notion AI widget at the top of Home.

• Search in your sidebar.

You can narrow your search to just GitHub by opening the All sources toggle in chat and Home and selecting GitHub. You can also filter Notion AI Search results to show only information from GitHub.

Who can connect GitHub to Notion AI?

When connecting GitHub to Notion AI for the first time, you must be a Notion workspace owner and a GitHub organization owner. Once the connection is made, members of your Notion workspace must log in to access repositories that they have access to.

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 going to Settings → Notion AI. Select ⚙️ next to GitHub → Settings → 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 everyone in my Notion workspace access information from GitHub?

Members in a workspace 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 Turbopuffer, which powers the ability to provide responses to questions that leverage third party content (e.g., GitHub). Turbopuffer has been vetted by our security team as well as an external auditor to obtain their SOC2 Type II certification. Learn more about Turbopuffer’s security here →