GitHubをNotionに接続する
プルリクエストをチームのプロジェクト計画と一緒にNotionで管理しましょう。
管理されたGitHub同期により、選択したリポジトリからGitHub Pull Requestsデータベースが作成されます。Notionは既存のプルリクエストをインポートし、バックグラウンドでGitHubの更新を確認します。
このガイドでは、GitHub接続設定のDatabase syncについて説明します。同期されたプロパティは読み取り専用です。プルリクエストへの変更はGitHubで行ってください。
備考: このGitHub連携は、従来のバージョンに代わるものです。外部データを最新の状態に保つには、2026年10月30日までに新しい同期を設定してください。既存の同期済みデータベースはNotionに残りますが、その日以降は更新が停止します。
GitHub Appのインストールを通じて利用可能な複数のリポジトリからプルリクエストを同期できます。選択したリポジトリは1つのNotionデータベースに集約されます。
情報 | プロパティ |
|---|---|
プルリクエスト | タイトル、PR番号、GitHub URL、リポジトリ |
状態 | 状態：オープン、ドラフト、マージ済み、またはクローズ済み |
作成者 | 作成者（GitHub）、および一致するNotionメンバーが見つかった場合の作成者 |
組織 | ラベル、ベースブランチ、ヘッドブランチ |
日付 | 作成日時、更新日時、クローズ日時、マージ日時 |
作成者（GitHub）プロパティにはGitHubのユーザー名が含まれます。作成者は、作成者の公開メールアドレスがワークスペースメンバーと一致する場合のNotionのユーザープロパティです。
説明プロパティは、プルリクエストの説明をプレインテキストとして同期し、GitHubに記述された通りにコピーされます。Markdownとしてはレンダリングされません。
この同期には、GitHubのIssue、コメント、担当者、レビューの詳細は含まれません。
必要なもの：
Notionワークスペースへのメンバーシップ。
同期したいリポジトリにアクセスできるGitHubアカウント。
それらのリポジトリにアクセスできるGitHub Appのインストール。
ビジネスプラン（モバイルビジネスプランも対象）。GitHub同期は他のプランでは利用できません。
GitHubアカウントとアプリのインストールの両方にアクセス権が必要です。GitHub組織によっては、オーナーによるアプリの承認やインストールが必要になる場合があります。
Notionで、設定 → コネクション → GitHubの順に開きます。
データベース同期を開き、まだ接続していない場合はGitHubアカウントを接続します。
GitHubの認証とインストールの手順を完了します。
同期したいリポジトリが含まれる組織またはアカウントを選択します。別のインストールを追加する必要がある場合は、組織を追加…を使用します。
含めるリポジトリを選択します。
利用可能なすべての履歴、または特定の期間の履歴を選択します。
Create sync を選択します。
NotionはプライベートサイドバーセクションにGitHubプルリクエストを作成し、一致するプルリクエストのインポートを開始します。
ヒント: リポジトリが見当たりませんか？GitHubの「Manage access（アクセス管理）」を使用して、アプリがアクセスできるリポジトリを確認してください。インストールに承認が必要な場合は、GitHub組織のオーナーに承認を依頼してください。
初回インポート時、Notionは選択した各リポジトリからプルリクエストを読み込みます。その際、最も最近更新されたレコードから順に、選択した履歴の範囲まで読み込みます。
インポート後、Notionは定期的に各リポジトリをチェックし、新規または更新されたプルリクエストがないか確認します。新しいラベル、プルリクエストのクローズ、マージなどの変更は、Notion内の対応するプロパティに反映されます。
同期はNotionを閉じている間も実行されます。大規模なリポジトリ、GitHubのリクエスト制限、一時的なサービスの問題により、更新が遅れることがあります。同期のステータスを確認して、進捗状況やエラーがないか確認してください。
すべての履歴、過去30日間、過去90日間、または過去365日間から選択します。すべての履歴を同期するオプションがトグルで提供されている場合は、利用可能なすべての履歴を同期をオンのままにすると、利用可能なすべてのプルリクエストが含まれます。
この期間は、プルリクエストの更新日時に基づきます。プルリクエストが作成された日時や、オープン、クローズ、マージのいずれの状態であるかは関係ありません。
例えば、90日以上変更されていないオープンなプルリクエストは、90日間の期間から外れる可能性があります。
ヒント: 古いページは削除できます。 プルリクエストが選択した期間外になると、そのページは同期データベースから削除され、Notionのプロパティ内の値も削除されます。変更されていないプルリクエストを保持する必要がある場合は、利用可能なすべての履歴を使用してください。
設定 → コネクション → GitHub → データベース同期から同期を開きます。
リポジトリを追加: 選択内容を編集して変更を保存を選択します。Notionは、追加されたリポジトリから一致するプルリクエストをインポートします。
リポジトリを削除: リポジトリの選択を解除して保存します。同期されていたプルリクエストページはNotionから削除されます。
変更履歴: ウィンドウを長くすると、追加のレコードがインポートされます。ウィンドウを短くすると、新しいウィンドウの外側にあるレコードが削除されます。
更新の一時停止:同期を一時停止を選択します。既存のデータと設定は保持されます。
更新の再開:同期を再開を選択して、同期を続行します。
リポジトリを削除したり履歴を短縮したりする前に、影響を受けるページから必要なNotion固有の情報を保存してください。
リポジトリ、状態、作成者、またはラベルごとにビューを作成します。独自のプロパティを追加してリリースの準備状況を追跡したり、プルリクエストをチームの計画プロセスと連携させたりできます。独自のプロパティ値はNotion内に保持されます。
GitHubプロパティを変更するには、GitHub URLを使用してプルリクエストを開き、GitHubで変更を行ってください。
データベースは最初はプライベートで作成されます。共有する場合、インポートされたデータを誰が閲覧できるかはNotionの共有設定によって決まります。閲覧者全員がソースリポジトリにアクセスできる必要はないため、プライベートリポジトリの情報を共有する前にデータベースの権限を確認してください。
組織やリポジトリが見つかりません
正しいGitHubアカウントとアプリのインストールが選択されていることを確認してください。アカウントとアプリの両方にリポジトリへのアクセス権があることを確認します。組織がアプリのインストールを制限している場合は、オーナーにアクセス権の承認を依頼してください。
リポジトリは名前が変更されたか、または移動されました。
同期のリポジトリ設定を開き、リポジトリ選択を確認後、再度保存してください。別の組織に移動している場合は、新しい場所でその接続がアクセスできるか確認してください。
「作成者」プロパティが空です。
GitHubのユーザー名には、Notionワークスペースのメンバーと一致する公開メールアドレスが常に利用できるとは限りません。プロパティが空の場合は、作成者 (GitHub)を使用して作成者を特定してください。作成者のメールアドレスやワークスペースのメンバーシップを変更しても、古い同期済みプルリクエストが自動的に更新されない場合があります。
プルリクエストがありません。
そのリポジトリが選択されていること、最終更新が履歴ウィンドウ内にあること、Notionのビューでフィルタリングされていないことを確認してください。最初のインポートがまだ実行中の可能性があります。
データベースは更新を停止しました。
同期のステータス詳細を開いてください。メッセージが表示されたら、GitHubアカウントを再接続するか、リポジトリへのアクセス権を復元してください。GitHubのリクエスト制限や一時的な停止により、Notionが再試行している間、更新が遅れることがあります。
Workersとの比較や共有のトラブルシューティングガイダンスについては、他のツールからNotionへデータを同期する →をご覧ください。
