Notion MCP Server

Notion とは

Notion は、文書・データベース・タスク・Wiki・カレンダーを一つにまとめられる多機能ノートアプリです。「メモアプリ」「Excel/スプレッドシート」「タスク管理ツール」「社内 Wiki」を 1 つのワークスペースで全部こなせるのが最大の特徴で、個人の知識管理から企業の社内ドキュメントまで幅広く使われています。

ページ同士をリンクで繋いだり、データベースで構造化したり、ブロックを自由に組み合わせたりできる柔軟性が魅力で、**「とりあえず Notion に書いておく」**がスタンダードになっているチームも多いです。プロダクトドキュメント・議事録・タスク管理・採用情報・社内ナレッジなど、業務文書の中心ハブとして機能します。

Notion × AI でできること

この MCP サーバーを導入すると、Notion のページ操作を AI への一言で実行できます。

📝 議事録を保存

「この会議の議事録を『会議メモ』DB に新しいページとして追加して」
→ 議事録を構造化ページとして自動保存

🔍 DB から検索

「『タスク管理』DB で未着手のタスクを期限順に一覧化して」
→ フィルタ + ソート付きで取得

✨ 内容を整理

「ページ ID xxxxx の内容を日本語で要約して新ページに保存して」
→ 既存ページ参照 + 要約 + 保存

📊 レポート生成

「先週追加されたタスクから進捗レポートを作って」
→ DB クエリ + 集計 + レポート化

提供される主なツール

Notion MCP Server は 22 ツールを提供します（README 明記範囲）。主要カテゴリ別:

機能カテゴリ	主なツール
ページ操作	post-page / retrieve-a-page / patch-page / move-page
データベース操作	query-data-source / retrieve-a-data-source / create-a-data-source / update-a-data-source / list-data-source-templates
データベース定義	retrieve-a-database
ブロック操作	ブロック取得・追加・更新・削除（ページ内の細かい要素の編集）
コメント	コメント追加・取得
検索	ワークスペース内のページ・DB を横断検索
ユーザー	ユーザー一覧・情報取得

「ページの中身を作る」「DB に情報を蓄積する」「検索する」というナレッジ管理の基本動詞がすべて揃っています。

Notion MCP Server について

Notion MCP Server は、Notion 社が公式に提供する MCP サーバーです。リモート型（mcp.notion.com/mcp）とローカル npm 版（@notionhq/notion-mcp-server）の 2 形態で配布されており、Notion 公式はリモート型を優先的に案内しています（ローカル版は将来 sunset される可能性に言及しつつ、npm パッケージは現在も更新継続中）。本ページの設定例もリモート型を推奨経路として記載しています。

リモート型は OAuth 認証で接続するためAPI トークンの手動発行は不要で、初回接続時にブラウザで Notion にログインするだけで利用開始できます。AI エージェント向けに最適化されたトークン効率の良いストリーミングにも対応した設計です。

スペック

• 配布形態: リモート型 MCP サーバー（Notion 管理）+ ローカル npm 版（@notionhq/notion-mcp-server・更新継続中）
• エンドポイント: https://mcp.notion.com/mcp（streamable HTTP）/ https://mcp.notion.com/sse（SSE）
• 認証: OAuth 2.1（ブラウザ）/ ローカル版は Bearer Token
• 提供元: Notion 社（公式）/ MIT
• 対応範囲: ページ / データベース / ブロック / コメント / 検索 / ユーザー（22 ツール）
• 公式ドキュメント: developers.notion.com/guides/mcp/get-started-with-mcp

導入手順

前提条件

• Notion アカウント（無料プランから利用可能）
• Node.js 18 以上（mcp-remote ブリッジ経由の場合）

ステップ（リモート版・推奨）

1. ページ上部のタブから使用環境（Claude Desktop / Cursor / Cline）を選択し、JSON 設定をコピー
2. コピーした JSON を設定ファイル（claude_desktop_config.json など）に追記して保存
3. クライアントを再起動
4. AI に「Notion に接続して」と話しかけると、ブラウザで OAuth 認証画面が開きます
5. Notion アカウントでログインして、AI に操作させたいページ・DB へのアクセスを許可

OAuth 認証時に操作対象のページ・データベースを明示的に選択できるため、ワークスペース全体へのアクセス権を渡さずに済みます。

ローカル npm 版を使う場合（互換性向け）

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "@notionhq/notion-mcp-server"],
      "env": {
        "OPENAPI_MCP_HEADERS": "{\"Authorization\": \"Bearer <YOUR_NOTION_API_TOKEN>\", \"Notion-Version\": \"2025-09-03\"}"
      }
    }
  }
}

Notion Integrations で Internal Integration を作成し、API トークンを発行する必要があります。

注意事項

• 公式はリモート版（mcp.notion.com/mcp）を優先的に案内しています。新規導入はリモート版を推奨します（ローカル npm 版も更新継続中ですが、公式は将来 sunset の可能性に言及）。
• リモート版は OAuth 認証を使用するため、API トークンの管理が不要です。認証時に AI がアクセスできるページ・DB を明示的に選べる設計です。
• ローカル版を使う場合、API トークンはソースコードやチャット履歴に含めないよう注意してください。
• Notion API には 1 秒あたり 3 リクエスト程度の制限があります。大量の操作は間隔をあけて実行してください。
• 共有ページへのアクセスは、認証時に許可した範囲に限定されます。アクセスできない場合は OAuth 認証で対象ページが許可されているか確認してください。

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
    }
  }
}

{
  "mcpServers": {
    "notion": {
      "url": "https://mcp.notion.com/mcp"
    }
  }
}

{
  "mcpServers": {
    "notion": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
    }
  }
}