Notion MCP Server

Notion MCP サーバー

Notion API 用の MCP サーバーです。Claude が Notion ワークスペースと連携できるようにします。

ツール

1. notion_append_block_children

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

2. notion_retrieve_block

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

3. notion_retrieve_block_children

   • 特定のブロックの子ブロックを取得します。
   • 必須入力：
     • block_id (string)：親ブロックの ID。
   • 任意入力：
     • start_cursor (string)：次の結果ページを取得するためのカーソル。
     • page_size (number, default: 100, max: 100)：取得するブロック数。
   • 戻り値：子ブロックの一覧。

4. notion_delete_block

   • 特定のブロックを削除します。
   • 必須入力：
     • block_id (string)：削除するブロックの ID。
   • 戻り値：削除の確認。

5. notion_retrieve_page

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

6. notion_update_page_properties

   • ページのプロパティを更新します。
   • 必須入力：
     • page_id (string)：更新するページの ID。
     • properties (object)：更新するプロパティ。
   • 戻り値：更新されたページに関する情報。

7. notion_create_database

   • 新しいデータベースを作成します。
   • 必須入力：
     • parent (object)：データベースの親オブジェクト。
     • title (array)：リッチテキスト配列形式のデータベースのタイトル。
     • properties (object)：データベースのプロパティスキーマ。
   • 戻り値：作成されたデータベースに関する情報。

8. notion_query_database

   • データベースをクエリします。
   • 必須入力：
     • database_id (string)：クエリするデータベースの ID。
   • 任意入力：
     • filter (object)：フィルター条件。
     • sorts (array)：並べ替え条件。
     • start_cursor (string)：次の結果ページを取得するためのカーソル。
     • page_size (number, default: 100, max: 100)：取得する結果の数。
   • 戻り値：クエリ結果の一覧。

9. notion_retrieve_database

   • 特定のデータベースに関する情報を取得します。
   • 必須入力：
     • database_id (string)：取得するデータベースの ID。
   • 戻り値：データベースに関する詳細情報。

10. notion_update_database

    • データベースに関する情報を更新します。
    • 必須入力：
      • database_id (string)：更新するデータベースの ID。
    • 任意入力：
      • title (array)：データベースの新しいタイトル。
      • description (array)：データベースの新しい説明。
      • properties (object)：更新後のプロパティスキーマ。
    • 戻り値：更新されたデータベースに関する情報。

11. notion_create_database_item

    • Notion データベースに新しい項目を作成します。
    • 必須入力：
      • database_id (string)：項目を追加するデータベースの ID。
      • properties (object)：新しい項目のプロパティ。データベースのスキーマに一致している必要があります。
    • 戻り値：新しく作成された項目に関する情報。

セットアップ

上記の手順について、以下の記事で詳しく説明しています。

• 英語版：https://dev.to/suekou/operating-notion-via-claude-desktop-using-mcp-c0h
• 日本語版：https://qiita.com/suekou/items/44c864583f5e3e6325d9

1. Notion インテグレーションを作成する：

   • Notion のインテグレーションページにアクセスします。
   • 「New Integration」をクリックします。
   • インテグレーションに名前を付け、適切な権限（例：「Read content」、「Update content」）を選択します。

2. シークレットキーを取得する：

   • インテグレーションの「Internal Integration Token」をコピーします。
   • このトークンは認証に使用します。

3. ワークスペースにインテグレーションを追加する：

   • インテグレーションにアクセスさせたいページまたはデータベースを Notion で開きます。
   • 右上のナビゲーションボタンをクリックします。
   • 「Connect to」ボタンをクリックし、インテグレーションを選択します。

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 License の下でライセンスされています。MIT License の利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できます。詳細については、プロジェクトリポジトリの LICENSE ファイルをご覧ください。