MCP Notion Server

🚀 mcp-notion-server

このプロジェクトは、Notion 統合用の Model Context Protocol サーバーです。TypeScript をベースに構築されたこの MCP サーバーは、Claude と Notion の間の橋渡しを行い、Notion のデータベースやページとのシームレスなやり取りを可能にします。

🚀 クイックスタート

この MCP サーバーは、Claude と Notion の間の橋渡しを行い、Notion のデータベースやページとのシームレスなやり取りを可能にします。以下の主要な MCP 概念を通じてその機能を発揮します。

• Notion ページとデータベースのリソース管理
• コンテンツの作成、読み取り、更新、削除（CRUD）操作ツール
• AI ベースのプロンプトコンテンツ分析

✨ 主な機能

リソース

• URI を通じて Notion ページとデータベースにアクセス
• 純テキストとリッチテキストのコンテンツタイプをサポート
• Notion 属性のメタデータを抽出

ツール

データベース操作

• list_databases - アクセス可能なすべての Notion データベースをリスト表示
• create_database - カスタム属性を持つ新しいデータベースを作成
• query_database - データベースエントリを検索およびフィルタリング
• update_database - データベース属性とスキーマを変更

ページ操作

• create_page - データベースまたはサブページに新しいページを作成
  • タイトル、属性、Markdown コンテンツをサポート
• update_page - 既存のページ属性を更新
• get_page - ページコンテンツとメタデータを取得
• delete_page - データベースまたは親ページからページを削除

ブロック操作

• append_blocks - ページに新しいブロックを追加
• delete_blocks - ページからブロックを削除
• get_blocks - ブロックコンテンツを取得
• update_blocks - 既存のブロックコンテンツを変更

プロンプト

• summarize_notes - ノートの簡潔な要約を生成
• analyze_content - ページコンテンツの洞察と分析を提供
• suggest_tags - コンテンツに基づいて関連タグを提案

📦 インストール

前提条件

• Node.js 18 以上
• Notion API キーと統合設定
• Claude Desktop アプリケーションのインストール

Claude Desktop との統合

Notion 統合を作成するには、以下の手順を実行します。

1. Notion の統合ページにアクセスします。
2. 「新しい統合」をクリックします。
3. 統合に名前を付け、適切な権限（例：「コンテンツの読み取り」、「コンテンツの更新」）を選択します。
4. シークレットキーを取得します。
5. 統合の「内部 Integration Token」をコピーします。このトークンは認証に使用されます。
6. 統合をワークスペースに追加します。
7. Notion で統合がアクセスするページまたはデータベースを開きます。
8. 右上のナビゲーションボタンをクリックします。
9. 「Connect to」ボタンをクリックし、統合を選択します。

設定の構成

Claude Desktop にサーバー設定を追加します。

MacOS:

~/Library/Application Support/Claude/claude_desktop_config.json

Windows:

%APPDATA%/Claude/claude_desktop_config.json

設定内容は次の通りです。

{
  "mcpServers": {
   "mcp-notion-server": {
      "command": "npx",
      "args": [
        "-y",
        "@gabornyerges/mcp-notion-server"
      ],
      "env": {
        "NOTION_API_KEY": "your-notion-api-key"
      }
    }
  }
}

デバッグ

MCP サーバーは stdio を介して通信するため、デバッグは困難な場合があります。MCP Inspector の使用をおすすめします。このツールはパッケージスクリプトとして利用できます。

1. MCP Inspector

npm run inspector

📄 ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細については LICENSE を参照してください。