Notion MCP サーバー
公式の Notion SDK を公開し、AI モデルが Notion ワークスペースと対話できるようにする Model Context Protocol (MCP) サーバー。
クイックスタート
1. Notionの統合を設定する
https://www.notion.so/my-integrationsにアクセスしてください。
新しい統合を作成する
APIキーをコピーする
2. Notionページを統合に接続する
統合によって Notion コンテンツにアクセスするには、ページまたはデータベースを明示的に共有する必要があります。
統合を通じてアクセスしたいNotionページまたはデータベースに移動します
右上隅の「共有」ボタンをクリックします
「ユーザー、グループ、または統合を追加」フィールドで、ドロップダウンリストから統合を選択します。
「招待」をクリック
アクセス可能にしたいページまたはデータベースごとに繰り返します
**注:**統合は、明示的に共有されたページとデータベースにのみアクセスできます。子ページは親ページからアクセスを自動的に継承します。
3. AIアシスタントに追加する
次のいずれかの構成形式を使用して、この MCP サーバーを Claude Desktop、Cursor AI、または Claude.ai に追加できます。
コマンドライン形式
JSON設定フォーマット
your-notion-integration-key手順 1 の API キーに置き換えます。
セットアップ手順
Claude Desktop ：設定 > 詳細設定 > モデルコンテキストプロトコル
カーソルAI : 設定 > AI > MCPサーバー
Claude.ai (Web) : プロフィール > 設定 > APIと統合 > モデルコンテキストプロトコル
Related MCP server: Notion MCP Server
利用可能なツール
サーバーは、Notion と対話するためのツールを提供します。
検索: ページまたはデータベースを検索
データベース: データベースエントリのクエリと取得
ページ: ページの作成、取得、更新
ブロック: コンテンツ ブロック (段落、リストなど) を管理します。
ユーザー: ユーザーを一覧表示し、ユーザー情報を取得する
コメント: コメントの作成と一覧表示
リンクプレビュー: URLのリンクプレビューを作成する
代替設定方法
環境変数の使用
API キーを直接渡す代わりに、 .envファイルを使用することもできます。
次の内容で
.envファイルを作成します。
サーバーを実行します。
環境変数を使用した JSON 構成 (Claude デスクトップ用)
JSON 構成形式で環境変数を使用することもできます。
コマンドラインオプション
トラブルシューティング
「クライアントの作成に失敗しました」というエラーが発生した場合:
Windowsでは、npxコマンドの前に
cmd /cを使用してください。macOS/Linuxでは、npxへのフルパスを使用してみてください。
AIアシスタントに追加する前に、ターミナルでコマンドをテストしてください
よくある問題
「リソースにアクセスできません」エラー: 特定のNotionページまたはデータベースを統合と共有していることを確認してください（手順2を参照）
共有メニューに統合が表示されません: ページを更新するか、ブラウザを再起動してください
機能が制限されています: Notionの統合設定で適切な機能が有効になっていることを確認してください
特徴
公式SDKによる完全なNotion APIサポート
シームレスなAI統合を実現するMCP準拠
Notionのあらゆる操作のための包括的なツール
詳細なメッセージによる堅牢なエラー処理
環境変数による簡単な設定
各ツールの詳細なドキュメントについては、ツールのドキュメントを参照してください。
ライセンス
このプロジェクトは、Apache License 2.0 に基づいてライセンスされています。詳細については、 LICENSEファイルを参照してください。