Notion

🚀 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 (オブジェクト): データベースのプロパティです。
   • 返却情報: 作成されたデータベースの ID です。

8. notion_retrieve_databases

   • すべてのデータベースを取得します。
   • 必須入力なし。
   • 返却情報: データベースのリストです。

9. notion_update_database_properties

   • データベースのプロパティを更新します。
   • 必須入力:
     • database_id (文字列): 更新するデータベースの ID です。
     • properties (オブジェクト): 更新するプロパティです。
   • 返却情報: 更新されたデータベースの情報です。

10. notion_delete_database

    • データベースを削除します。
    • 必須入力:
      • database_id (文字列): 削除するデータベースの ID です。
    • 返却情報: 削除の確認です。

11. notion_search

    • 内容を検索します。
    • 必須入力:
      • query (文字列): 検索キーワードです。
    • オプション入力:
      • page_size (数値): ページごとの結果数です。
      • cursor (文字列): ページング用のカーソルです。
    • 返却情報: 検索結果です。

📦 インストール

設定ガイド

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 ファイルを参照してください。