Notion x GitHub Action

Connect your GitHub issues to a Notion database.

Like this GitHub Action? Give us a ⭐️ and follow us on Twitter for more drops 🪂.

Quick Start

1. Create a new internal Notion integration and note the value of the Internal Integration Token.
2. In your GitHub repository, go to Settings > Secrets, and add a New repository secret. Set the Name to NOTION_TOKEN and the Value to the Internal Integration Token you created in the previous step.
3. Set up your Notion Database. Use this template and duplicate it to your workspace.
4. In your Notion Database page's Share menu, add the Notion integration you created as a member with the Can edit privilege. You may have to type your integration's name in the Invite field.

5. Find the ID of your Database by copying the link to it. The link will have the format

   https://www.notion.so/abc?v=123

   where abc is the database id.

6. Add the Database's ID as a repository secret for your GitHub repository. Set the Name to NOTION_DATABASE and the Value to the id of your Database.

7. In your GitHub repository, create a GitHub workflow file at the path .github/workflows/issues-notion-sync.yml.

on:
  issues:
    types: [opened, edited, labeled, unlabeled, assigned, unassigned, milestoned, demilestoned, reopened, closed]

jobs:
  notion_job:
    runs-on: ubuntu-latest
    name: Add GitHub Issues to Notion
    steps:
      - name: Add GitHub Issues to Notion
        uses: instantish/notion-github-action@v1.1.0
        with:
          notion-token: ${{ secrets.NOTION_TOKEN }}
          notion-db: ${{ secrets.NOTION_DATABASE }}

Built with 💙 by the team behind Fabric.