Notion

• AIエージェントに、ミーティングノート、タスクエントリー、レポートの生成など、Notionページの自動作成や更新を行わせたい場合。
• フィルターや並べ替えを使ってNotionデータベースにクエリを実行し、構造化されたレコード（例：アクティブなタスク、CRMエントリー、プロジェクトトラッカー）を取得する必要がある場合。
• 既存のページにコンテンツブロック（段落、リストなど）をプログラムで追加したい場合。
• 自動化されたワークフローの一環として、Notionページ内に新しいデータベース（データソース）を作成する必要がある場合。

• データベースのビューフィルターを設定または変更する必要がある場合 — これらはUIのみの機能であり、APIを通じて変更することはできません。
• 非常に高いスループットの操作が必要な場合 — Notion APIのレート制限は約3リクエスト/秒であり、大量処理のボトルネックになる可能性があります。
• 対象のページまたはデータベースがNotionインテグレーションと共有されていない場合。アクセスはNotionのUIで手動で付与する必要があります。

ページのメタデータとコンテンツの取得、データベース内または他のページの子ページとしての新規ページ作成、および PATCH によるページプロパティの更新が可能です。タイトル、リッチテキスト、セレクト、日付、チェックボックス、URL、リレーションなど、一般的なすべてのプロパティタイプに対応しています。

フィルターと並び替え順序を使用してNotionデータベースをクエリするには、APIバージョン 2025-09-03 で導入された /data_sources/{id}/query エンドポイントを利用します。ステータス、日付、セレクトフィールドなどのプロパティ値でフィルタリングし、ページネーションされた結果を取得できます。

段落やその他のブロックタイプを含むリッチなコンテンツブロックを、任意のページに直接追加できます。ページのブロックツリー全体を取得して、コンテンツ構造を読み取ることも可能です。

既存のページの子要素として、新しい構造化データベース（データソース）を作成します。タイトル、セレクト、日付などを含むカスタムプロパティスキーマを設定できます。is_inline: true を使用すると、ページ内にインラインで埋め込むことができます。

/search エンドポイントを使用して、インテグレーションがアクセス可能なすべてのページおよびデータベースを横断的に検索します。結果にはページとデータソースの両方が含まれ、それぞれのオブジェクトタイプとIDによって識別されます。

このスキルは Notion API バージョン 2025-09-03 を対象としており、データソースの命名規則が導入されています。デュアルIDシステム（database_id と data_source_id）および各IDをいつ使用すべきかについて、詳細なガイダンスを提供しています。

エージェントは、特定のステータス（例：「アクティブ」）を持つアイテムについて Notion プロジェクトデータベースにクエリを実行し、作業の進捗に応じてプロパティを更新し、新しいタスクエントリを作成することができます。これにより、Notion ワークスペースを外部イベントやエージェントの判断と常に同期させることが可能です。

レポート、サマリー、またはブリーフィングを生成した後、エージェントは新しいNotionページを作成し、コンテンツを構造化されたブロックとして追加することができます。これにより、AIの出力結果をチームのナレッジベースにすぐに反映させることができます。

リード、連絡先、またはデータポイントが収集される際に、構造化されたプロパティ（名前、ステータス、日付、URL）を持つ新しいレコードをNotionデータベースに自動的に追加し、手動によるデータ入力を不要にします。

エージェントは、タイトルキーワードによって関連するページやデータベースをNotionワークスペース内で検索し、そのコンテンツを取得することができます。これにより、後続の推論や要約タスクに向けたコンテキストの取得が可能になります。