MCP Server Notion

🚀 Notion MCP サーバー

Claude AI と Notion ワークスペースをシームレスに統合するための Model Context Protocol (MCP) サーバーの実装で、読み取りと書き込み機能をサポートしています。

🚀 クイックスタート

1. Notion API アクセス権の設定

1. https://www.notion.so/my-integrations で Notion インテグレーションを作成します。
2. インテグレーションに名前を付けます（例：“Claude MCP Integration”）。
3. インテグレーションタイプを“Internal”に設定します。
4. API キーをコピーします。
5. 任意のページ/データベースの右上にある“...”メニューをクリックし、“接続を追加”を選択して、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 データベース内のエントリを検索およびフィルタリングします。

📚 ドキュメント

プロジェクト概要

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

• Notion データベースとページから内容を読み取る
• 既存の内容を更新する
• Notion ワークスペース全体で検索する
• データベースエントリをクエリおよびフィルタリングする
• 詳細なページ内容とデータベーススキーマを取得する

前提条件

• Node.js (v16+)
• Notion API キー
• Claude Desktop

📄 ライセンス

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

🔗 リソースと参考資料

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

🤝 コントリビューション

コントリビューションを歓迎します！自由に Pull Request を送信してください。