Notion MCP Server

Notion MCP サーバー

Claude AI と Notion ワークスペースをシームレスに統合し、読み取りと書き込みを可能にする MCP（Model Context Protocol）サーバーの実装です。

プロジェクト概要

このプロジェクトは、Claude AI を Notion ワークスペースに接続する MCP サーバーの構築を目的としています。これにより、Claude は次の操作を行えます。

• Notion のデータベースやページのコンテンツを読み取る
• 既存のコンテンツを更新する
• Notion ワークスペース全体を検索する
• データベースのエントリを検索し、フィルタリングする
• ページの詳細なコンテンツとデータベースのスキーマを取得する

前提条件

• Node.js（v16 以降）
• Notion API キー
• Claude Desktop

はじめに

1. Notion API アクセスを設定する

1. https://www.notion.so/my-integrations で Notion インテグレーションを作成します
2. インテグレーションに名前を付けます（例：「Claude MCP Integration」）
3. インテグレーションの種類を「Internal」に設定します
4. API キーをコピーします
5. ページまたはデータベースの右上にある「...」メニューをクリックして「Add connections」を選択し、Notion のページやデータベースをインテグレーションと共有します

2. 依存関係をインストールする

npm install

3. 環境変数を設定する

プロジェクトのルートに .env ファイルを作成し、Notion API キーを設定します。

NOTION_API_KEY=your_api_key_here

この手順が必要なのは、サーバーを開発する場合のみです。

4. ビルドする

サーバーをビルドし、Claude で使用できる状態にします。

npm run build

サーバーを開発する場合は、npm run dev または npm run inspect を実行できます。

5. Claude Desktop の設定に追加する

claude_desktop_config.json を開き（Settings > Developer に移動して Edit Config をクリック）、次の内容を追加します。

"notion": {
  "command": "node",
  "args": [
    "path/to/mcp-server-notion/dist/index.js"
  ],
  "env": {
    "NOTION_API_KEY": "your_notion_api_key_here"
  }
}

6. Claude を再起動する

Claude を再起動すれば、使用できるようになります。

利用可能な機能

MCP サーバーでは、次のツールを利用できます。

• search_notion：クエリ文字列を使って Notion ワークスペース全体を検索します
• get_notion_page：特定の Notion ページから詳細なコンテンツを取得します
• get_notion_database：Notion データベースのメタデータとスキーマを取得します
• query_notion_database：複雑なクエリに対応し、Notion データベースのエントリを検索してフィルタリングします

リソースと参考情報

• Notion API 公式ドキュメント
• Model Context Protocol 仕様
• MCP サーバーの実装例
• Claude 開発者向けドキュメント

貢献

貢献を歓迎します。お気軽にプルリクエストを送信してください。

ライセンス

このプロジェクトは MIT ライセンスのもとで公開されています。詳細については LICENSE ファイルをご覧ください。