Notion MCP サーバー
Notionワークスペースと統合するためのモデルコンテキストプロトコル（MCP）サーバー。このサーバーは、AIモデルがNotion内のコンテンツにアクセス、クエリ、変更するための標準化されたインターフェースを提供します。
前提条件
Node.js (v16 以上)
Notion APIキー（ Notion統合から）
適切な権限を持つ接続された Notion ワークスペース
Related MCP server: Notion MCP Server
インストール
このリポジトリをクローンします:
git clone https://github.com/yourusername/notion-mcp-server.git cd notion-mcp-server依存関係をインストールします:
npm installルート ディレクトリに Notion API キーを使用して
.envファイルを作成します。# Required NOTION_API_KEY=your_notion_api_key_here # Optional settings DEBUG=false REQUIRE_CONFIRMATION_FOR_CREATE=true REQUIRE_CONFIRMATION_FOR_UPDATE=true REQUIRE_CONFIRMATION_FOR_DELETE=true UPDATE_POLLING_INTERVAL=60000 MAX_BLOCK_DEPTH=3 BACKUP_DIR=./backups BACKUP_RETENTION_DAYS=30 MAX_BACKUPS_PER_PAGE=5プロジェクトをビルドします。
npm run buildサーバーを起動します。
npm start
Claude for Desktop と併用
この Notion MCP サーバーを Claude for Desktop で使用するには:
Claude for Desktopがインストールされ、最新バージョンに更新されていることを確認してください
Claude for Desktop の設定ファイルを開きます。
macOSの場合:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows の場合:
%APPDATA%\Claude\claude_desktop_config.json
サーバー構成を追加します。
{ "mcpServers": { "notion": { "command": "node", "args": ["/path/to/notion-mcp-server/build/index.js"], "env": { "NOTION_API_KEY": "your_notion_api_key_here" } } } }ファイルを保存し、Claude for Desktopを再起動します。
リソース
サーバーは次のリソースを公開します。
リソースURI | 説明 |
| ワークスペース内のすべてのデータベースを一覧表示します |
| 特定のデータベースのスキーマを取得します |
| 特定のデータベースからすべてのページ/アイテムを取得します |
| 特定のページのコンテンツを取得します |
| ワークスペース内の最近の更新と変更を取得します |
ツール
サーバーは次のツールを提供します。
プロンプト
サーバーには、次の事前構成されたプロンプトが含まれています。
プロンプト名 | 説明 |
| 今後の締め切りのリストを取得する |
| プロジェクトの状況を要約する |
| 今日のタスクリストを取得する |
クエリの例
Claude に接続すると、Notion ワークスペースについて自然言語で質問できるようになります。
「私のワークスペースで今日期限が切れるタスクは何ですか？」
「プロジェクトXのステータスを教えてください」
「「アイデア」データベースに「新機能コンセプト」というタイトルの新しいページを作成します」
「タスクYのステータスを「完了」に更新する」
「過去 24 時間以内にワークスペースにどのような変更が加えられましたか?」
「来週の締め切りをまとめます」
「ページ abc123 のすべてのバックアップを表示」
「バックアップファイルpage_abc123_2023-01-01.jsonからページabc123を復元する」
サーバーの拡張
新しい機能を追加するには:
リソースの追加:
index.tsのリソース ハンドラーを拡張します。ツールの追加:
index.tsに新しいツール定義を作成するプロンプトの追加:
index.tsに新しいプロンプト テンプレートを定義します。API統合の強化：
notion-api.tsに新しいAPI関数を追加
ログ
詳細なエラー情報については、サーバー ログを確認してください。
Claude のデスクトップ ログ: MCP 関連のログについては、Claude のログ ディレクトリを参照してください。
サーバー出力: サーバーログの標準出力とエラーストリームを確認します