Akirapapa MCP Notion Server

🚀 Notion MCP サーバー

Notion API を使用して実装された MCP（機械学習制御平面）サーバーで、Claude が Notion ワークスペースと相互作用できるようにします。

✨ 主な機能

ツール

1. notion_append_block_children

   • 親ブロックに子ブロックを追加します。
   • 必須入力:
     • block_id (文字列): 親ブロックの ID。
     • children (配列): 追加するブロックオブジェクトの配列。
   • 戻り値: 追加されたブロックに関する情報。

2. notion_retrieve_block

   • 特定のブロックの詳細情報を取得します。
   • 必須入力:
     • block_id (文字列): 取得するブロックの ID。
   • 戻り値: そのブロックに関する詳細情報。

3. notion_retrieve_block_children

   • 特定のブロックの子ブロックを取得します。
   • 必須入力:
     • block_id (文字列): 親ブロックの ID。
   • オプション入力:
     • start_cursor (文字列): 次のページの結果のカーソル。
     • page_size (数値、デフォルト値: 100、最大値: 100): 取得するブロックの数。
   • 戻り値: 子ブロックのリスト。

4. notion_delete_block

   • 特定のブロックを削除します。
   • 必須入力:
     • block_id (文字列): 削除するブロックの ID。
   • 戻り値: 削除が確認された情報。

5. notion_retrieve_page

   • 特定のページの詳細情報を取得します。
   • 必須入力:
     • page_id (文字列): 取得するページの ID。
   • 戻り値: そのページに関する詳細情報。

6. notion_update_page_properties

   • ページのプロパティを更新します。
   • 必須入力:
     • page_id (文字列): 更新するページの ID。
     • properties (オブジェクト): 更新するプロパティ。
   • 戻り値: 更新されたページに関する情報。

7. notion_create_database

   • 新しいデータベースを作成します。
   • 必須入力:
     • parent (オブジェクト): データベースの親オブジェクト。
     • title (配列): データベースのタイトル（リッチテキスト配列）。
     • properties (オブジェクト): データベースのプロパティ。
   • 戻り値: 新しく作成されたデータベース。

8. notion_delete_database

   • 特定のデータベースを削除します。
   • 必須入力:
     • database_id (文字列): 削除するデータベースの ID。
   • 戻り値: 削除が確認された情報。

9. notion_retrieve_databases

   • すべてのデータベースのリストを取得します。
   • 戻り値: データベースのリスト。

10. notion_query_database

    • 特定のデータベースの内容をクエリします。
    • 必須入力:
      • database_id (文字列): クエリするデータベースの ID。
      • query (オブジェクト): クエリパラメータ。
    • 戻り値: データベースのクエリ結果。

11. notion_create_page

    • 新しいページを作成します。
    • 必須入力:
      • parent (オブジェクト): ページの親オブジェクト。
      • properties (オブジェクト): ページのプロパティ。
      • children (配列): 初期の子ブロック。
    • 戻り値: 新しく作成されたページ。

📦 インストール

設定ガイド

Notion で MCP サーバーを構成するには、以下の手順に従ってください。

1. Notion 統合を作成する Notion で新しい統合を作成し、必要な権限（「読み取りと書き込み」など）を有効にします。

2. 統合トークンを取得する 作成が完了したら、統合のトークン（API トークンとも呼ばれます）をコピーします。これが後続の設定のキーとなります。

3. 統合をワークスペースに接続する

   • Notion の関連するページまたはデータベースを開きます。
   • 右上のナビゲーションバーのボタンをクリックします。
   • 「接続先」ボタンをクリックし、統合を選択します。

4. Claude Desktop を構成する claude_desktop_config.json ファイルに以下の内容を追加します。

   {
       "mcpServers": {
           "notion": {
               "command": "node",
               "args": ["your-built-file-path"],
               "env": {
                   "NOTION_API_TOKEN": "your-integration-token"
               }
           }
       }
   }
   

🔧 トラブルシューティング

権限エラーが発生した場合は、以下の手順を実行してください。

1. 統合が必要な権限を持っていることを確認します。
2. 統合が関連するページまたはデータベースに招待されていることを検証します。
3. claude_desktop_config.json でトークンと設定が正しく設定されていることを確認します。

📄 ライセンス

この MCP サーバーは MIT ライセンスの下で公開されています。これは、MIT ライセンスの条項と条件に従う限り、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリ内の LICENSE ファイルを参照してください。