{"id":29636674,"url":"https://github.com/brpaz/github-stars-notion-sync","last_synced_at":"2026-05-15T23:05:41.883Z","repository":{"id":215957993,"uuid":"740128042","full_name":"brpaz/github-stars-notion-sync","owner":"brpaz","description":"Command Line tool to sync your GitHub starred repos to a Notion database","archived":false,"fork":false,"pushed_at":"2025-02-09T19:09:11.000Z","size":73,"stargazers_count":7,"open_issues_count":7,"forks_count":2,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-07-21T18:02:45.540Z","etag":null,"topics":["github-stars","golang","notion"],"latest_commit_sha":null,"homepage":"","language":"Go","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/brpaz.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE.md","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-01-07T15:59:54.000Z","updated_at":"2025-07-20T20:14:24.000Z","dependencies_parsed_at":null,"dependency_job_id":"7fe6477a-3de4-4b43-8389-9ed3edd8ce66","html_url":"https://github.com/brpaz/github-stars-notion-sync","commit_stats":null,"previous_names":["brpaz/github-stars-notion-sync"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/brpaz/github-stars-notion-sync","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brpaz%2Fgithub-stars-notion-sync","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brpaz%2Fgithub-stars-notion-sync/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brpaz%2Fgithub-stars-notion-sync/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brpaz%2Fgithub-stars-notion-sync/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/brpaz","download_url":"https://codeload.github.com/brpaz/github-stars-notion-sync/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/brpaz%2Fgithub-stars-notion-sync/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33082798,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-15T20:25:35.270Z","status":"ssl_error","status_checked_at":"2026-05-15T20:25:34.732Z","response_time":103,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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":["github-stars","golang","notion"],"created_at":"2025-07-21T17:34:08.568Z","updated_at":"2026-05-15T23:05:41.866Z","avatar_url":"https://github.com/brpaz.png","language":"Go","funding_links":["https://github.com/sponsors/brpaz","https://www.buymeacoffee.com/Z1Bu6asGV"],"categories":[],"sub_categories":[],"readme":"[![github-workflow-shield]][github-workflow-url]\n[![Contributors][contributors-shield]][contributors-url]\n[![MIT License][license-shield]][license-url]\n[![Go Version][gomod]][gomod-url]\n\n\u003cbr /\u003e\n\n\u003cdiv\u003e\n\u003ch3 align=\"center\"\u003eGitHub Stars Notion sync\u003c/h3\u003e\n\n  \u003cp align=\"center\"\u003e\n    A command line tool to sync your GitHub starred repositories with a \u003ca href=\"https://notion.com\"\u003eNotion\u003c/a\u003e database.\n  \u003c/p\u003e\n\u003c/div\u003e\n\n\u003c!-- TABLE OF CONTENTS --\u003e\n\u003cdetails\u003e\n  \u003csummary\u003eTable of Contents\u003c/summary\u003e\n  \u003col\u003e\n    \u003cli\u003e\n      \u003ca href=\"#about-the-project\"\u003eAbout The Project\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#built-with\"\u003eBuilt With\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\n      \u003ca href=\"#getting-started\"\u003eGetting Started\u003c/a\u003e\n      \u003cul\u003e\n        \u003cli\u003e\u003ca href=\"#prerequisites\"\u003ePrerequisites\u003c/a\u003e\u003c/li\u003e\n        \u003cli\u003e\u003ca href=\"#installation\"\u003eInstallation\u003c/a\u003e\u003c/li\u003e\n      \u003c/ul\u003e\n    \u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#usage\"\u003eUsage\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#roadmap\"\u003eRoadmap\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contributing\"\u003eContributing\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#license\"\u003eLicense\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#contact\"\u003eContact\u003c/a\u003e\u003c/li\u003e\n    \u003cli\u003e\u003ca href=\"#acknowledgments\"\u003eAcknowledgments\u003c/a\u003e\u003c/li\u003e\n  \u003c/ol\u003e\n\u003c/details\u003e\n\n\n## ℹ️ About The Project\n\nThis project allows to syncronize your starred repositories from GitHub to a Notion database, allowing easily filtering your favorite GitHub using the advanced features of a Notion database.\n\n### Built With\n\n* Golang and [Cobra](https://cobra.dev)\n\n## 🚀 Getting Started\n\n### Setup your notion database.\n\nFor this integration to work properly, you must create a Notion database with at least the following collumns:\n\n| Field            | Type            | Description                                                                                     |\n|------------------|-----------------|-------------------------------------------------------------------------------------------------|\n| Name             | text            | This field will store the name of the GitHub repository.                                        |\n| Description      | text            | This field will store the description of the GitHub repository.                                 |\n| Language         | select          | This field will store the main language of the GitHub repository.                                |\n| Topics           | multi-select    | This field will store the topics of the GitHub repository.                                       |\n| Repository URL   | url             | This field will store the URL of the GitHub repository.                                          |\n| Repository ID    | number | Internal field that will store the repository ID. You can hide it from the table but must not change. It is used to keep track of the already synced repository. |\n| Created Time     | time            | Will keep track of the date this repository was synced. You can also hide it from the table but must not be removed. |\n\n\u003e [!TIP]\n\u003e You can have any other collumns in your database. They won´t be touched by this command.\n\nYou can use [this template](https://brpaz-dev.notion.site/75dd9254235f4577a9d4d259df6a2b64?v=a2ecaa84752c4699b02a982fbb8872a6\u0026pvs=4) to get started.\n\n### Configure notion integration\n\nNext you need to create a Notion API Token and give it access to your database.\n\n1. **Create a Notion integration:** Go to https://www.notion.so/my-integrations and create a new integration. Give it a name like \"GitHub stars Syncer\" and associate in to the workspace where your database is. Make sure to save the generated token in a Safe place.\n2. **Enable integration for your database**: Open your Notion database page, and on the `...` menu at top right, click on \"Connections\" -\u003e \"Add connection\" and select the integration you created on 1. This will ensure the integration have access to your database.\n3. **Find your database id** - Open your database page in Notion. You should see in your browser an url similar to `https://www.notion.com/fer6ff3d5fcs3dff1d2134349192cc?v=4rf43545..`. Grab the first id. This is your database id. You will need to convert it to UUID format, by splitting the characters with `-`, in the pattern `8-4-4-12`. This example id would be `550e8400-e29b-41d4-a716-446655440000` as uuid.\n\n### Create a GitHub access token.\n\nYou will also need a GitHub access token, in order to retrieve your starred repos from GitHub\n\n1. Login in GitHub and open `https://github.com/settings/tokens`\n2. Create a new \"General token\" with `read:user` permission.\n\n\n### Installation\n\n1. Download the latest release from [GitHub](https://github.com/brpaz/github-stars-notion-sync/releases) for your operating system.\n\n## ▶️ Usage\n\nTo sync your GitHub starred repos with your Notion database, run the following command:\n\n```shell\ngithub-stars-notion-sync sync --github-token=\u003ctoken\u003e --notion-token=\u003cnotion-token\u003e --notion-database-id=\u003cdatabase-id\u003e\n```\n\nInstead of using flags to set the command options, you can also use envrionment variables.\n\nEx:\n\n```shell\nGITHUB_TOKEN=\u003cgithub-token\u003e NOTION_TOKEN=\u003cnotion-token\u003e NOTION_DATABASE_ID=\u003cdatabase-id\u003e github-stars-notion-sync sync\n```\n\n### Run with docker\n\nIf you prefer, you can also use Docker.\n\n```shell\ndocker run --rm \\\n    -e GITHUB_TOKEN=\u003ctoken\u003e \\\n    -e NOTION_TOKEN=\u003cnotion-token\u003e \\\n    -e NOTION_DATABASE_ID=\u003cdatabase-id\u003e \\\n    ghcr.io/brpaz/github-stars-notion-sync:latest sync\n```\n\n\n## 🤝 Contributing\n\nContributions are what make the open source community such an amazing place to learn, inspire, and create. Any contributions you make are **greatly appreciated**.\n\nIf you have a suggestion that would make this better, please fork the repo and create a pull request. You can also simply open an issue with the tag \"enhancement\".\nDon't forget to give the project a star! Thanks again!\n\n1. Fork the Project\n2. Create your Feature Branch (`git checkout -b feature/AmazingFeature`)\n3. Commit your Changes (`git commit -m 'Add some AmazingFeature'`)\n4. Push to the Branch (`git push origin feature/AmazingFeature`)\n5. Open a Pull Request\n\n## 🫶 Support\n\nIf you find this project helpful and would like to support its development, there are a few ways you can contribute:\n\n[![Sponsor me on GitHub](https://img.shields.io/badge/Sponsor-%E2%9D%A4-%23db61a2.svg?\u0026logo=github\u0026logoColor=red\u0026\u0026style=for-the-badge\u0026labelColor=white)](https://github.com/sponsors/brpaz)\n\n\u003ca href=\"https://www.buymeacoffee.com/Z1Bu6asGV\" target=\"_blank\"\u003e\u003cimg src=\"https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png\" alt=\"Buy Me A Coffee\" style=\"height: auto !important;width: auto !important;\" \u003e\u003c/a\u003e\n\n## 📃 License\n\nDistributed under the MIT License. See [LICENSE](LICENSE.md) file for details.\n\n## 📩 Contact\n\n- Bruno Paz - [https://brunopaz.dev](https://brunopaz.dev) - oss@brunopaz.dev\n\n## 🏅 Acknowledgments\n\n* [Anatoly Nosov](https://github.com/jomei) for creating the [Notion API golang client](https://github.com/jomei/notionapi), which helped a lot building this integration.\n\n\u003c!-- MARKDOWN LINKS \u0026 IMAGES --\u003e\n\u003c!-- https://www.markdownguide.org/basic-syntax#reference-style-links --\u003e\n[contributors-shield]: https://img.shields.io/github/contributors/brpaz/github-stars-notion-sync.svg?style=for-the-badge\n[contributors-url]: https://github.com/brpaz/github-stars-notion-sync/graphs/contributors\n[license-shield]: https://img.shields.io/github/license/brpaz/github-stars-notion-sync.svg?style=for-the-badge\n[license-url]: https://github.com/brpaz/github-stars-notion-sync/blob/main/LICENSE.md\n[github-workflow-shield]: https://img.shields.io/github/actions/workflow/status/brpaz/github-stars-notion-sync/ci.yml?style=for-the-badge\n[github-workflow-url]: https://github.com/brpaz/github-stars-notion-sync/actions\n[gomod]:  https://img.shields.io/github/go-mod/go-version/brpaz/github-stars-notion-sync?style=for-the-badge\n[gomod-url]: https://github.com/brpaz/github-stars-notion-sync\n\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrpaz%2Fgithub-stars-notion-sync","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbrpaz%2Fgithub-stars-notion-sync","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbrpaz%2Fgithub-stars-notion-sync/lists"}