GitHubをNotionに接続する
プルリクエストをチームのプロジェクト計画と一緒にNotionで管理しましょう。
管理型のGitHub同期では、指定したGitHubのプルリクエストやイシュー、またはその両方をNotionに取り込めます。Notionは既存のレコードをインポートし、バックグラウンドでGitHubの更新を確認します。
このガイドでは、GitHub接続設定のデータベース同期について説明します。同期されたプロパティは読み取り専用です。プルリクエストやイシューへの変更はGitHubで行ってください。
備考: このGitHub連携は、従来のバージョンに代わるものです。外部データを最新の状態に保つには、2026年10月30日までに新しい同期を設定してください。既存の同期済みデータベースはNotionに残りますが、その日以降は更新が停止します。
データベース同期を設定すると、Notionは「プライベート」セクションに新しいページを作成します。従来の同期は置き換えられないため、作業を移行する間は両方がそのまま残ります。
ヒント：設定はNotion AIに移行してもらいましょう。次のようなプロンプトを試してみてください。「従来のGitHubデータベース（@メンションで従来の同期を指定）のフィルターを確認して、新しいGitHubデータベース（@メンションで新しいデータベース同期を指定）にも同じフィルターを設定して」
GitHub Appのインストールを通じて利用可能なリポジトリから、Notionに取り込む対象（プルリクエスト、イシュー、またはその両方）を選択します。選択したリポジトリのデータがNotionに取り込まれます。
情報 | プロパティ |
|---|---|
プルリクエスト | タイトル、PR番号、GitHub URL、リポジトリ |
状態 | 状態：オープン、ドラフト、マージ済み、またはクローズ済み |
作成者 | 作成者（GitHub）、および一致するNotionメンバーが見つかった場合の作成者 |
組織 | ラベル、ベースブランチ、ヘッドブランチ |
日付 | 作成日時、更新日時、クローズ日時、マージ日時 |
作成者（GitHub）プロパティにはGitHubのユーザー名が含まれます。作成者は、作成者の公開メールアドレスがワークスペースメンバーと一致する場合のNotionのユーザープロパティです。
説明プロパティは、プルリクエストの説明をプレインテキストとして同期し、GitHubに記述された通りにコピーされます。Markdownとしてはレンダリングされません。
GitHubイシューを単独で、またはプルリクエストと組み合わせて同期できます。この同期には、プルリクエストのコメントやレビューの詳細は含まれません。
必要なもの：
Notionワークスペースへのメンバーシップ。
同期したいリポジトリにアクセスできるGitHubアカウント。
それらのリポジトリにアクセスできるGitHub Appのインストール。
ビジネスプラン（モバイルビジネスプランも対象）。GitHub同期は他のプランでは利用できません。
GitHubアカウントとアプリのインストールの両方にアクセス権が必要です。GitHub組織によっては、オーナーによるアプリの承認やインストールが必要になる場合があります。
Notionで、設定 → コネクション → GitHubの順に開きます。
データベース同期を開き、まだ接続していない場合はGitHubアカウントを接続します。
GitHubの認証とインストールの手順を完了します。
同期したいリポジトリが含まれる組織またはアカウントを選択します。別のインストールを追加する必要がある場合は、組織を追加…を使用します。
含めるリポジトリを選択します。
同期に名前を付け、Notionに取り込む対象（プルリクエスト、イシュー、またはその両方）を選択します。
利用可能なすべての履歴、または特定の期間の履歴を選択します。
Create sync を選択します。
Notionはサイドバーの「プライベート」セクションに同期データベースを作成し、該当するレコードのインポートを開始します。
ヒント: リポジトリが見当たりませんか？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へデータを同期する →をご覧ください。
