Notion MCP サーバー

Claude やその他の AI アシスタントを Notion ワークスペースに接続する Model Context Protocol (MCP) サーバー。この統合により、AI アシスタントは Notion のデータベース、ページ、ブロックとやり取りできるようになります。

これは何ですか？

このツールは、AIアシスタント（Claudeなど）とNotionワークスペースをつなぐ橋渡しとして機能します。AIは以下のことが可能になります。

Notionデータベースの表示と検索
ページの作成と更新
コンテンツブロックを管理する
その他にも多数あります!

Related MCP server: Notion MCP Server

ステップバイステップのセットアップガイド

前提条件

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

1. Notion APIキーの取得

https://www.notion.so/my-integrationsにアクセスしてください。
青い**「+新しい統合」**ボタンをクリックします
詳細を入力してください:
- 名前: 「Claude Assistant」や「AI Helper」などの名前を選択します
- ロゴ: オプション
- 関連ワークスペース: Notionワークスペースを選択してください
**「送信」**をクリック
次のページで、 **「内部統合トークン」**セクションを見つけます
**「表示」**をクリックしてトークンをコピーします（ secret_で始まります）。

2. このサーバーの設定

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

オプションA: ZIP形式でダウンロード（初心者に推奨）

GitHub リポジトリに移動します: https://github.com/Sjotie/notionMCP/
右上の緑色の「コード」ボタンをクリックします
「ZIPをダウンロード」を選択
ダウンロードしたら、ZIPファイルをコンピュータ上の場所に解凍します。
- Windows: ZIPファイルを右クリックし、「すべて展開」を選択します。
- Mac: ZIPファイルをダブルクリックして解凍します

オプション B: Git でクローンする (Git に慣れているユーザー向け)

コマンドプロンプトまたはターミナルを開きます
- Windows: Win+Rを押して、 cmdと入力し、Enter を押します。
- Mac: アプリケーション > ユーティリティからターミナルを開きます
リポジトリを保存する場所に移動します
cd path/to/desired/location
リポジトリをクローンする
git clone https://github.com/Sjotie/notionMCP/

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

ダウンロードまたはクローン作成後、 cd (ディレクトリ変更) コマンドを使用してプロジェクトフォルダーに移動する必要があります。

ZIP をダウンロードした場合 (オプション A):

コマンドプロンプトまたはターミナルを開きます
cdコマンドを使用して、ZIP ファイルを抽出した場所に移動します。
cd path/to/extracted/folder/notionMCP
例えば：
- Windowsの場合: cd C:\Users\YourName\Downloads\notionMCP
- Macの場合: cd /Users/YourName/Downloads/notionMCP

Git でクローンした場合 (オプション B):

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

正しいディレクトリにいるかどうかを確認する方法:

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

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

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

npm install

これで必要なNode.jsパッケージがすべてインストールされます。プログレスバーが表示され、インストールが完了したことを示すメッセージが表示されます。「Xパッケージが資金を探しています」といったメッセージが表示される場合もありますが、これは全く正常な動作であり、正常にインストールされたことを意味します。

3. Notionページへの接続

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

Notionを開き、AIにアクセスさせたいページまたはデータベースに移動します
右上隅の**「•••」** （3つの点）をクリックします
**「接続を追加」**を選択
先ほど作成した統合を見つけて選択します
アクセス可能にしたい他のページやデータベースについても繰り返します

4. Claude Desktopへの接続

Claude Desktop 構成ファイルを見つけます。
- Windows: %APPDATA%\Claude\claude_desktop_config.json (このパスをファイルエクスプローラーのアドレスバーに入力してください)
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json (Finder で、Cmd+Shift+G を押してこのパスを貼り付けます)
テキストエディタでファイルを開きます。ファイルが存在しない場合は、以下の内容で作成してください。
{ "mcpServers": { "notion": { "command": "node", "args": [ "C:\\path\\to\\notion-mcp-server\\server.js" ], "env": { "NOTION_API_KEY": "your_notion_api_key_here" } } } }
交換する：
- C:\\path\\to\\notion-mcp-server\\server.js server.js ファイルへの実際のパスに置き換えます。
  - Windows: パスに二重のバックスラッシュ (\\) を使用します
  - Mac: スラッシュ (/) を使用する
- your_notion_api_key_hereに Notion API キーを入力します
ファイルを保存し、Claude Desktopを再起動します。

5. 接続のテスト

クロードで新しい会話を始める
Claude に Notion ワークスペースを操作するように依頼します。例:
- 「Notionデータベースのリストを表示」
- 「タスクデータベースに「テストタスク」というタイトルの新しいページを作成します」

利用可能なツール

サーバーは 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 : 特定のブロックを表示する
検索: ワークスペース全体のコンテンツを検索

トラブルシューティング

よくある問題:

クロードの「接続に失敗しました」
- claude_desktop_config.json のサーバーパスが正しいことを確認してください
- Notion APIキーが有効であることを確認してください
- Node.jsがインストールされていることを確認する
Notionコンテンツにアクセスすると「アクセスが拒否されました」
- ページ/データベースを統合で共有していることを確認してください
- APIキーに必要な権限があることを確認してください
サーバーが起動しません
- すべての依存関係がインストールされていることを確認する（ npm install ）
- APIキーを含む.envファイルが存在することを確認してください

ヘルプの取得

ここで説明されていない問題が発生した場合は、次の手順に従ってください。

コンソール出力でエラーメッセージを確認します
Notion APIキーが有効であることを確認してください
統合がページ/データベースにアクセスできることを確認する

ライセンス

マサチューセッツ工科大学

Notion MCP Server