Notion MCP Server (Official)

🚀 Notion MCP サーバー

このプロジェクトは、Notion API 用の MCP サーバー を実装しています。

🚀 クイックスタート

この Notion MCP サーバーを使用することで、Notion API を通じて様々な操作を行うことができます。以下に、サーバーのインストール方法と使用例を説明します。

✨ 主な機能

• Notion API を通じたコメントの追加
• ページ内容の取得
• コンテンツの検索

📦 インストール

1. Notion での統合設定

https://www.notion.so/profile/integrations にアクセスし、新しい 内部 統合を作成するか、既存の統合を選択します。

Notion API の公開範囲を制限していますが（例えば、MCP を通じてデータベースを削除することはできません）、データを LLM に公開することには一定のリスクがあります。セキュリティを重視するユーザーは、統合の 機能 をさらに設定することをお勧めします。

例えば、「内容の読み取り」アクセス権のみを付与する読み取り専用の統合トークンを作成することができます。これは「設定」タブから選択できます。

2. クライアントへの MCP 設定の追加

npm を使用する場合

.cursor/mcp.json または claude_desktop_config.json（MacOS: ~/Library/Application\ Support/Claude/claude_desktop_config.json）に以下の内容を追加します。

{
  "mcpServers": {
    "notionApi": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer ntn_****\", \"Notion-Version\": \"2022-06-28\" }"
      }
    }
  }
}

Docker を使用する場合

MCP サーバーを Docker で実行する方法は 2 つあります。

方法 1: 公式 Docker イメージを使用する

docker-compose.yml に以下の内容を追加して MCP サーバーを起動します。

version: '3'
services:
  notion-mcp-server:
    image: ghcr.io/notionhq/notion-mcp-server:latest
    ports:
      - "19000:19000"

その後、以下のコマンドを実行します。

docker-compose up --build

方法 2: ローカルでビルドして実行する

依存関係をインストールします。

npm install @notionhq/notion-mcp-server --save-dev

package.json にスクリプトを追加します。

{
  "scripts": {
    "mcp-server": "npx -y --prefix . @notionhq/notion-mcp-server"
  }
}

以下のコマンドを実行します。

npm run mcp-server

3. 内容を統合に接続する

Notion で、接続したい内容（ページまたはデータベース）に移動し、サイドバーの「設定」メニューを使用して、その内容を以前に作成した統合に接続します。

💻 使用例

基本的な使用法

1. コメントの追加

post http://localhost:19000/comments
Content-Type: application/json

{
  "parent": "page_id",
  "content": "こはテストコメントです。"
}

2. ページ内容の取得

get http://localhost:19000/page_content?page_id=page_id

3. コンテンツの検索

post http://localhost:19000/search
Content-Type: application/json

{
  "query": "検索する内容"
}

🔧 技術詳細

ビルド

npm run build

実行

npx -y --prefix /path/to/local/notion-mcp-server @notionhq/notion-mcp-server

公開

npm publish --access public