{"id":13659997,"url":"https://github.com/tryfabric/notion-github-action","last_synced_at":"2025-07-15T13:02:19.831Z","repository":{"id":38344097,"uuid":"367212967","full_name":"tryfabric/notion-github-action","owner":"tryfabric","description":"A GitHub Action that syncs new GitHub issues to a Notion database 🤖","archived":false,"fork":false,"pushed_at":"2023-05-08T18:40:55.000Z","size":2688,"stargazers_count":95,"open_issues_count":19,"forks_count":24,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-06-19T05:19:47.707Z","etag":null,"topics":["actions","fabric","github","github-actions","issue-management","issues","notion","notion-api","notion-blocks"],"latest_commit_sha":null,"homepage":"","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/tryfabric.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-14T01:01:44.000Z","updated_at":"2025-06-05T06:50:38.000Z","dependencies_parsed_at":"2024-06-19T17:34:34.799Z","dependency_job_id":"ac4f227a-3318-45fe-b1b8-f56f9a5ac297","html_url":"https://github.com/tryfabric/notion-github-action","commit_stats":{"total_commits":147,"total_committers":9,"mean_commits":"16.333333333333332","dds":0.6122448979591837,"last_synced_commit":"f9ed5055c439e20e3f3f3a86e308b40d954ac42e"},"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/tryfabric/notion-github-action","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryfabric%2Fnotion-github-action","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryfabric%2Fnotion-github-action/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryfabric%2Fnotion-github-action/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryfabric%2Fnotion-github-action/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/tryfabric","download_url":"https://codeload.github.com/tryfabric/notion-github-action/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/tryfabric%2Fnotion-github-action/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":265437597,"owners_count":23765124,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["actions","fabric","github","github-actions","issue-management","issues","notion","notion-api","notion-blocks"],"created_at":"2024-08-02T05:01:14.731Z","updated_at":"2025-07-15T13:02:19.781Z","avatar_url":"https://github.com/tryfabric.png","language":"TypeScript","readme":"# Notion x GitHub Action\n\n[![Code Style: Google](https://img.shields.io/badge/code%20style-google-blueviolet.svg)](https://github.com/google/gts)\n\nConnect your GitHub issues to a Notion database.\n\n**Like this GitHub Action?** Give us a ⭐️ and [follow us on Twitter for more drops 🪂](https://twitter.com/tryfabric).\n\n---\n\n## Quick Start\n\n1. [Create a new internal Notion integration](https://www.notion.so/my-integrations) and note the value of the Internal Integration Token.\n2. In your GitHub repository, go to `Settings` \u003e `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.\n3. Set up your Notion Database. Use [this template](https://www.notion.so/tryfabric/067329ee12044ec49b7db6b39b26920a?v=38dd7e968874436c810a5e604d2cf12c) and duplicate it to your workspace. \u003cimg width=\"683\" alt=\"Screen Shot 2021-06-14 at 11 37 51 AM\" src=\"https://user-images.githubusercontent.com/1459660/121919427-0194ed80-cd05-11eb-81e2-6692099afae7.png\"\u003e\n4. 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. \u003cimg width=\"719\" alt=\"Screen Shot 2021-06-14 at 11 41 25 AM\" src=\"https://user-images.githubusercontent.com/1459660/121919912-7f58f900-cd05-11eb-8e7b-960ba0d4519e.png\"\u003e\n5. Find the ID of your Database by copying the link to it. The link will have the format\n\n```\nhttps://www.notion.so/abc?v=123\n```\n\nwhere `abc` is the database id.\n\n6. 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.\n\n7. In your GitHub repository, create a GitHub workflow file at the path `.github/workflows/issues-notion-sync.yml`.\n\n```yaml\nname: Notion Sync\n\non:\n  workflow_dispatch:\n  issues:\n    types:\n      [\n        opened,\n        edited,\n        labeled,\n        unlabeled,\n        assigned,\n        unassigned,\n        milestoned,\n        demilestoned,\n        reopened,\n        closed,\n      ]\n\njobs:\n  notion_job:\n    runs-on: ubuntu-latest\n    name: Add GitHub Issues to Notion\n    steps:\n      - name: Add GitHub Issues to Notion\n        uses: tryfabric/notion-github-action@v1\n        with:\n          notion-token: ${{ secrets.NOTION_TOKEN }}\n          notion-db: ${{ secrets.NOTION_DATABASE }}\n```\n\n8. (Optional) If your Github repository has any preexisting issues that you would like to sync to your new Notion Database you can trigger a manual workflow. Make sure your organization's default `GITHUB_TOKEN` has [read and write permissions](https://docs.github.com/en/organizations/managing-organization-settings/disabling-or-limiting-github-actions-for-your-organization#setting-the-permissions-of-the-github_token-for-your-organization) then follow [these intructions](https://docs.github.com/en/actions/managing-workflow-runs/manually-running-a-workflow) to run the `Notion Job` workflow.\n\n_Note: The manual workflow will only work on Notion Databases created from the templated linked above._\n\n## Using `release-it`\n\n1. Locally, on `master` (make sure it's up to date), execute `GITHUB_TOKEN=\u003cTOKEN\u003e release-it`. (Alternatively, set `GITHUB_TOKEN` as a system environment variable)\n2. Follow the interactive prompts, selecting `Yes` for all options.\n3. When selecting the increment, choose `patch` when the release is only bug fixes. For new features, choose `minor`. For major changes, choose `major`.\n\nRelease-It will then automatically generate a GitHub release with the changelog inside.\n\n---\n\nBuilt with 💙 by the team behind [Fabric](https://tryfabric.com).\n","funding_links":[],"categories":["HarmonyOS","TypeScript"],"sub_categories":["Windows Manager"],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftryfabric%2Fnotion-github-action","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ftryfabric%2Fnotion-github-action","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ftryfabric%2Fnotion-github-action/lists"}