Notion MCP Server

Notion MCP サーバー

Notion API 向けの、AI に使いやすい MCP サーバーです。エージェントが Notion ワークスペースを検索、読み取り、クエリ、更新できるようにしながら、日々の AI ワークフローで扱いやすい簡潔な応答を維持します。

このサーバーは Notion API 2026-03-11 を対象とし、現行のデータベース／データソースモデルを使用します。MCP ツール、プロンプト、リソース、構造化されたツールの結果、および対話型の Notion ワークフロー向けのオプションの MCP Apps を公開します。

主な機能

• notion_find による検索と対象の特定。
• notion_read_page による、安定したブロック ID を備えた簡潔なページ読み取り。
• notion_inspect_data_source によるデータソーススキーマの確認。
• シンプルな値を使った、スキーマに対応するデータソースのクエリとアイテム作成。
• 段落、見出し、リスト、ToDo、引用、コールアウト、コードブロック、区切り線、および安全な Markdown の追記に対応するシンプルなページ編集ツール。
• ブロック、ページ、データベース、データソース、コメント、ユーザーを操作する高度な機能向けの、Notion API 生ツール。
• オプションの MCP Apps：Data Source Explorer と Page Workbench。

クイックスタート

Claude Desktop などの MCP ホストにこのサーバーを追加します。

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "your-integration-token"
      }
    }
  }
}

設定を保存した後、MCP ホストを再起動してください。

セットアップガイド

1. Notion インテグレーションを作成する

Notion インテグレーションダッシュボードを開き、新しい内部インテグレーションを作成します。

2. 機能を設定する

必要な機能のみを許可します。

• コンテンツの読み取り：検索、ページの読み取り、データソースの取得、クエリに必要です。
• コンテンツの挿入：ページ／アイテムの作成とブロックの追記に必要です。
• コンテンツの更新：ページ、ブロック、データソーススキーマの更新に必要です。
• コメントの読み取り／コメントの挿入：コメントツールを使う場合にのみ必要です。
• ユーザー情報：ユーザー検索ツールを使う場合にのみ必要です。

セットアップ時にすべての機能を使うには、コンテンツの読み取り、挿入、更新を有効にしてください。コメント機能またはユーザー機能を使う予定がある場合にのみ、それらの機能を追加してください。

3. コンテンツへのアクセスを許可する

インテグレーションの コンテンツアクセス タブを開き、MCP サーバーに読み取りまたは編集を許可するページやデータベースを選択します。

対象の Notion ページまたはデータベースからアクセスを許可することもできます。... メニューを開き、接続 を選択して、インテグレーションを追加します。

Notion では、インテグレーションと共有されたページおよびデータベースのみがアクセス対象になります。ページに追加された接続は、そのページの子ページにもアクセスできます。

4. 内部インテグレーショントークンをコピーする

インテグレーションシークレットをコピーします。この値を MCP ホストの設定で NOTION_API_TOKEN として指定します。

5. MCP ホストを設定する

Cursor、Claude Desktop、その他の MCP ホストでは、このサーバー設定を MCP 設定に追加します。

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@suekou/mcp-notion-server"],
      "env": {
        "NOTION_API_TOKEN": "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

ローカルでビルドしたチェックアウトを使用する場合：

{
  "mcpServers": {
    "notion": {
      "command": "node",
      "args": ["/absolute/path/to/suekou-mcp-notion-server/build/index.js"],
      "env": {
        "NOTION_API_TOKEN": "secret_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

推奨ワークフロー

1. notion_find を使ってページまたはデータソースを特定します。
2. notion_read_page を使って、ページのコンテキストと編集可能なブロック ID を取得します。
3. データソースのクエリまたはアイテム作成の前に、notion_inspect_data_source を使います。
4. 一般的なデータソース操作には、notion_query_data_source_by_values と notion_create_data_source_item_from_values を使います。
5. 通常のページ編集には、notion_append_markdown、notion_append_content、notion_update_content、または notion_update_content_batch を使います。
6. 簡易ツールで必要な Notion API の形式に対応できない場合にのみ、生の JSON ツールを使います。

開発者向け

以下のリファレンスは、主に開発、カスタマイズ、高度な MCP ワークフローを対象としています。

• 設定：環境変数、コマンドライン引数、MCP ホストの例、開発コマンド、トラブルシューティング。
• ツール：ワークフロー領域ごとに分類したツールの完全なリファレンス。
• ワークフロー：実用的な読み取り、書き込み、データソース、移行、エラー処理に関するガイダンス。
• MCP Apps：インタラクティブな Data Source Explorer と Page Workbench の詳細。

開発

このプロジェクトでは、Node.js 22 以降と pnpm を使用します。

pnpm install --frozen-lockfile
pnpm run build
pnpm test

ローカル開発では、MCP inspector を使用してください。

pnpm run inspector

ライセンス

この MCP サーバーは MIT License のもとでライセンスされています。これは、MIT License の利用規約に従うことを条件に、ソフトウェアを自由に使用、変更、配布できることを意味します。詳細については、プロジェクトリポジトリの LICENSE ファイルをご覧ください。