Notion MCP Server

Notion MCP サーバー

Claude やその他の AI アシスタントを Notion ワークスペースに接続する Model Context Protocol（MCP）サーバーです。この連携により、AI アシスタントが Notion のデータベース、ページ、ブロックを操作できるようになります。

これは何ですか？

このツールは、AI アシスタント（Claude など）と Notion ワークスペースをつなぐ橋渡し役です。AI は次の操作を行えます。

• Notion のデータベースを表示して検索する
• ページを作成して更新する
• コンテンツブロックを管理する
• その他、さまざまな操作を行う

ステップごとのセットアップガイド

前提条件

• Node.js（バージョン 14 以降）
• Notion アカウント
• Claude デスクトップアプリ（Claude と併用する場合）

1. Notion API キーの取得

1. https://www.notion.so/my-integrations にアクセスします
2. 青い "+ New integration" ボタンをクリックします
3. 詳細を入力します。
   • Name： 「Claude Assistant」や「AI Helper」などの名前を選びます
   • Logo：任意
   • Associated workspace：Notion ワークスペースを選択します
4. "Submit" をクリックします
5. 次のページで "Internal Integration Token" セクションを探します
6. "Show" をクリックしてトークンをコピーします（secret_ で始まります）

2. このサーバーのセットアップ

リポジトリをダウンロード

オプション A：ZIP としてダウンロード（初心者におすすめ）

1. GitHub リポジトリにアクセスします：https://github.com/Sjotie/notionMCP/
2. 右上にある緑色の「Code」ボタンをクリックします
3. 「Download ZIP」を選択します
4. ダウンロードが完了したら、ZIP ファイルをコンピューター上の場所に展開します
   • Windows：ZIP ファイルを右クリックして「すべて展開」を選択します
   • Mac：ZIP ファイルをダブルクリックして展開します

オプション B：Git でクローン（Git に慣れている方向け）

1. コマンドプロンプトまたはターミナルを開きます
   • Windows：Win+R を押し、cmd と入力して Enter キーを押します
   • Mac：「アプリケーション」>「ユーティリティ」からターミナルを開きます
2. リポジトリを保存する場所に移動します

   cd path/to/desired/location
   

3. リポジトリをクローンします

   git clone https://github.com/Sjotie/notionMCP/
   

プロジェクトディレクトリに移動

ダウンロードまたはクローンが完了したら、cd（ディレクトリ変更）コマンドを使ってプロジェクトフォルダーに移動します。

ZIP をダウンロードした場合（オプション A）：

1. コマンドプロンプトまたはターミナルを開きます

2. cd コマンドを使って、ZIP ファイルを展開した場所に移動します。

   cd path/to/extracted/folder/notionMCP
   

   例：

   • Windows の場合：cd C:\Users\YourName\Downloads\notionMCP
   • Mac の場合：cd /Users/YourName/Downloads/notionMCP

Git でクローンした場合（オプション B）：

1. リポジトリは「notionMCP」という名前のフォルダーにクローンされているはずです
2. クローン後も同じターミナルウィンドウを開いている場合は、次のように入力するだけです。

   cd notionMCP
   

正しいディレクトリにいることを確認する方法：

• cd コマンドを実行した後、現在の場所を確認できます。
  • Windows の場合：dir と入力して Enter キーを押します。server.js などのファイルが表示されます
  • Mac の場合：ls と入力して Enter キーを押します。server.js などのファイルが表示されます

依存関係のインストール

notionMCP ディレクトリに移動したら、必要な依存関係をインストールします。

npm install

必要な Node.js パッケージがすべてインストールされます。進行状況バーが表示され、最終的にインストール完了を示すメッセージが表示されます。「X Packages are looking for funding」のようなメッセージが表示される場合がありますが、これはまったく問題なく、正常に動作したことを意味します。

3. Notion ページへの接続

セキュリティ上、Notion では各ページまたはデータベースへのアクセスを明示的に許可する必要があります。

1. Notion を開き、AI にアクセスさせたいページまたはデータベースに移動します
2. 右上の "•••"（3 つの点）をクリックします
3. "Add connections" を選択します
4. 先ほど作成したインテグレーションを探して選択します
5. アクセス可能にしたい他のページやデータベースについても同じ手順を繰り返します

4. Claude Desktop への接続

1. Claude Desktop の設定ファイルを探します。

   • Windows：%APPDATA%\Claude\claude_desktop_config.json （このパスをエクスプローラーのアドレスバーに入力します）
   • Mac：~/Library/Application Support/Claude/claude_desktop_config.json （Finder で Cmd+Shift+G を押して、このパスを貼り付けます）

2. テキストエディターでファイルを開きます。ファイルが存在しない場合は、次の内容で作成します。

   {
     "mcpServers": {
       "notion": {
         "command": "node",
         "args": [
           "C:\\path\\to\\notion-mcp-server\\server.js"
         ],
         "env": {
           "NOTION_API_KEY": "your_notion_api_key_here"
         }
       }
     }
   }
   

3. 次の内容を置き換えます。

   • C:\\path\\to\\notion-mcp-server\\server.js を、server.js ファイルの実際のパスに置き換えます。
     • Windows：パスにはバックスラッシュを 2 つ（\\）使用します。
     • Mac：スラッシュ（/）を使用します。
   • your_notion_api_key_here を Notion API キーに置き換えます。

4. ファイルを保存し、Claude Desktop を再起動します。

5. 接続のテスト

1. Claude で新しい会話を開始します。
2. たとえば、次のように依頼して、Notion ワークスペースを操作します。
   • 「Notion データベースの一覧を表示してください」
   • 「Tasks データベースに、タイトルが『Test Task』の新しいページを作成してください」

利用可能なツール

このサーバーは、AI アシスタントに次のツールを提供します。

• list-databases：アクセス可能なすべてのデータベースを表示します。
• query-database：データベースからエントリーを取得します。
• create-page：データベースに新しいページを追加します。
• update-page：既存のページを変更します。
• create-database：新しいデータベースを作成します。
• update-database：データベースの構造を変更します。
• get-page：特定のページを表示します。
• get-block-children：コンテンツブロックを表示します。
• append-block-children：ページにコンテンツを追加します。
• update-block：コンテンツブロックを編集します。
• get-block：特定のブロックを表示します。
• search：ワークスペース全体からコンテンツを検索します。

トラブルシューティング

よくある問題：

1. Claude で「Connection failed」と表示される

   • claude_desktop_config.json のサーバーパスが正しいことを確認します。
   • Notion API キーが有効であることを確認します。
   • Node.js がインストールされていることを確認します。

2. Notion のコンテンツにアクセスすると「Access denied」と表示される

   • ページまたはデータベースがインテグレーションと共有されていることを確認します。
   • API キーに必要な権限があることを確認します。

3. サーバーが起動しない

   • すべての依存関係がインストールされていることを確認します（npm install）。
   • API キーを記載した .env ファイルが存在することを確認します。

ヘルプの利用

ここに記載されていない問題が発生した場合は、次のことを行ってください。

• コンソール出力でエラーメッセージを確認します。
• Notion API キーが有効であることを確認します。
• インテグレーションがページやデータベースにアクセスできることを確認します。

ライセンス

MIT