
2026年10月31日更新。接続手順、ツール名、プラン条件、レート制限は、Notionの開発者向けドキュメントと各クライアントの公式資料でこの日に確認しました。
結論: Notion MCPは、Notionが運営する公式のMCPサーバーです。URLは https://mcp.notion.com/mcp です。Claude Code、Cursor、ChatGPTなどのMCPクライアントにこのURLを追加してNotionアカウントでOAuth認証すると、AIが自分のアクセスできるページやデータベースを検索・閲覧・作成・更新できます。接続はすべてのNotionプランで無料です。ブラウザ認証なしで使うMCPトークン、外部ソース検索、高いレート制限はBusiness・Enterpriseプランが対象です。
notion-mcp-server)は保守が終了しています。MCP自体が初めての場合は、先にMCPとは何かを読むと、この記事の手順が理解しやすくなります。
Notion MCPは、Notionがホストし保守しているリモートMCPサーバーです。MCPクライアントをOAuthで認証すると、クライアントはNotionのツールを呼び出して、ページ、データベース、コメント、ファイルを検索・閲覧・作成・更新できます。どの操作も、ログインしたNotionメンバーの権限の範囲内で実行されます。
仕組みとしてはNotion APIの上に作られていますが、REST APIのエンドポイントをそのまま公開するのではなく、AIが扱いやすいツールの形で提供しています。そのため、利用者がコードを書く必要はありません。

検索すると「Notion MCPサーバー」が2種類見つかりますが、役割は同じではありません。
| ホスト型Notion MCP | オープンソース版 notion-mcp-server | |
|---|---|---|
| 動く場所 | Notionのインフラ(mcp.notion.com) | 自分のPCやサーバー(npmパッケージ) |
| 状態(2026年10月) | 推奨・サポート対象 | 公式に「積極的な保守は終了」と明記 |
| 認証 | ユーザーごとのOAuth。Business・EnterpriseはMCPトークンも可 | Notionインテグレーションのトークン |
| 見える範囲 | ログインしたメンバーがアクセスできるすべて | インテグレーションに共有したページだけ |
| 選ぶ場面 | ほぼすべての場合 | 社内ネットワーク内で完結させる必要があるなど、例外的な場合 |
出典:Notion MCPの接続ガイドとFAQ、makenotion/notion-mcp-server。Google Antigravityのギャラリーにある既定の「Notion」は古いパッケージを使うため、Notionはホスト型URLをカスタムサーバーとして追加するよう案内しています。
どのクライアントでも、最後は同じ流れです。ブラウザが開いたらNotionにログインし、ワークスペースを選んで承認します。以下の設定例は、2026年10月31日時点のNotion公式の接続ガイドに基づきます。
claude mcp add --transport http notion https://mcp.notion.com/mcp
追加したら、Claude Codeのセッションで /mcp を実行し、OAuth認証を完了します。チームで共有するなら --scope project、すべてのプロジェクトで使うなら --scope user を付けます。/context を実行すると、有効なMCPサーバーごとのトークン消費量を確認できます。スコープの考え方とトラブル対応はClaude CodeにMCPサーバーを追加する方法で詳しく解説しています。
プロジェクト直下に .cursor/mcp.json を作成します(すべてのプロジェクトで使う場合は ~/.cursor/mcp.json)。
{
"mcpServers": {
"notion": {
"url": "https://mcp.notion.com/mcp"
}
}
}
Cursorの設定画面(Customize)からNotionを有効にし、OAuth認証を完了します。
.vscode/mcp.json を作成します。VS Codeではキー名が mcpServers ではなく servers で、type の指定が必須です。
{
"servers": {
"notion": {
"type": "http",
"url": "https://mcp.notion.com/mcp"
}
}
}
コマンドパレットから「MCP: List Servers」を実行し、Notionを起動してログインします。
~/.codex/config.toml(チームで共有する場合はプロジェクトの .codex/config.toml)に追記します。
[mcp_servers.notion]
url = "https://mcp.notion.com/mcp"
続けて codex mcp login notion を実行します。
Claudeでは、コネクタのディレクトリからNotionを追加するか、上記URLをカスタムコネクタとして追加します。Anthropicのカスタムコネクタのヘルプによると、カスタムコネクタはFreeプランでも使えますが、Freeでは1つまでです。接続はPCからではなくAnthropicのクラウドから行われます。
ChatGPTでは、NotionをアプリとしてChatGPTに接続できます。任意のMCPサーバーを追加する開発者モードは、OpenAIのヘルプページでBusiness・Enterprise・Eduのワークスペース向けとされ、管理者が制御します。どちらの製品もプランごとの提供条件がよく変わるため、導入前に最新のヘルプを確認してください。
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
}
}
}
mcp-remoteはブリッジで、接続先はホスト型サーバーのまま、認証もOAuthです。Streamable HTTPに対応していないクライアントでは、https://mcp.notion.com/sse を使います。

接続できたら、答えがわかっている質問で試します。 たとえば「ベンダー見積もりを比較したページを探して、最終候補をリンク付きで一覧にして」と依頼します。正しく動いていれば、実在するページのURLを示して答えます。見つからない場合は、同じアカウントでNotionを開き、そのページを表示できるか確認してください。自分が開けないページは、MCPからも見えません。
Notionの対応ツール一覧には、2026年10月31日時点で40を超えるツールが載っています。よく使うものは次のとおりです。
| やりたいこと | ツール | 依頼の例 | プランの条件 |
|---|---|---|---|
| ページを探す | notion-search | 「先週のモバイルリリースに関する議事録を探して」 | 全プラン |
| Slack・Google Drive・Jiraなどを探す | notion-connector-search | 「料金変更についてSlackで話した内容をまとめて」 | Business・EnterpriseかつNotion AI |
| ページやデータベースを読む | notion-fetch | 「Q4ロードマップを読んで、未解決のリスクを挙げて」 | 全プラン |
| データベースを照会する | notion-query-data-sources | 「期限切れで担当者がいないタスクを一覧にして」 | 保存済みビューは全プラン。SQLはBusiness・EnterpriseかつNotion AIで無制限(その他のプランは1データソースあたり回数制限あり) |
| ページを作る・更新する | notion-create-pages、notion-update-page | 「この会議メモを議事録データベースに今日の日付で登録して」 | 全プラン |
| コメントする | notion-create-comment、notion-get-comments | 「仕様書にAPI制限の確認依頼をコメントして」 | 全プラン |
| ファイルを添付する | notion-create-file-upload | 「この図を設計ページに添付して」 | 全プラン(1ファイル20MiBまで) |
| 使えるツールを確かめる | notion-get-tool-access | 「このワークスペースのプランで使えない検索条件は?」 | 全プラン |
プランにない検索条件を指定すると、その条件は無視され、結果にその旨が表示されます。そのため、思ったより広い結果が返ることがあります。また、管理者が作成したワークスペース共通の接続では、選択されたツールだけが表示されます。
公式FAQによると、Notion MCPはすべてのプランで使えます。ただし、次の機能はプランに依存します。
notion-connector-search): Notion AIを契約したBusiness・Enterprise。Notion内の検索(notion-search)は全プランで使えます。ゲストは接続できません。ワークスペースのメンバーだけがNotion MCPを使えます。

接続したクライアントは、ログインしたメンバーがアクセスできるものをすべて読み書きできます。さらに、読んだ内容をNotionの外のシステムへ送る可能性もあります。Notionのセキュリティガイドの要点は次の6つです。
https://mcp.notion.com/mcp か /sse 以外のURLは使いません。マーケットプレイスから入れる場合もURLを確認します。
| 症状 | 考えられる原因 | 対処 |
|---|---|---|
| リモートサーバーを追加できない | クライアントがstdioにしか対応していない | 上記の mcp-remote の設定を使う |
| OAuthの画面がループする・失敗する | クライアントに古い認証情報が残っている | クライアントで認証をクリア(Disconnect)して再接続する |
| 「ゲストは接続できません」と表示される | そのワークスペースのゲストである | メンバーになるか、メンバーとして所属するワークスペースに接続する |
| あるはずのページが見つからない | アカウントにアクセス権がない、またはプラン外の条件が無視された | 同じアカウントでページを開けるか確認し、結果の注意書きを見る |
| SlackやDriveの結果が出ない | Notion AI付きのBusiness・Enterpriseではない、または外部ソース未接続 | notion-search はNotion内だけが対象。プランと接続を確認する |
rate_limited エラーが出る | 並列での呼び出しが多すぎる | 1件ずつ処理するよう依頼し、指定された秒数を待って再試行する |
API-post-database-query など古いツール名が出る | 保守終了のローカル版を使っている | https://mcp.notion.com/mcp に切り替える |
データベース中心で運用しているチームにとって、どれも大きな問題にはなりにくい制約です。影響が出るのは、意思決定が図やホワイトボードに残っている場合と、データを自社環境に置くことが必須の場合です。
開示:このブログはAFFiNEが運営しています。ナレッジベース向けMCPサーバーを比較する読者からよく質問されるため、この節を設けました。AFFiNEに関する記述は、AFFiNEの公式ドキュメントに書かれている範囲に限っています。
チームの知識がNotionのデータベースにあるなら、Notion MCPが適しています。AFFiNEのMCPサーバーが向くのは別のケースで、文書とEdgelessホワイトボードを同じワークスペースで扱い、AFFiNE Cloudでもセルフホスト環境(英語ページ)でも同じサーバーを使える点が特徴です。
| Notion MCP | AFFiNE MCP | |
|---|---|---|
| 提供形態 | Notionがホスト | AFFiNE Cloudとセルフホスト環境に内蔵 |
| 認証 | OAuth。Business・EnterpriseはMCPトークンも可 | クライアントごとのBearer認証情報(有効期限・失効に対応) |
| 既定の権限 | 自分の権限内で読み書き | 既定は読み取り専用 |
| ツール | 40以上(ページ・DB・コメント・ファイルなど) | doc_search と read_document |
| ホワイトボード | データモデルの対象外 | キャンバス上のテキストをインデックス化し、要素とフレームの位置を返す |
| 接続費用 | 全プラン無料(一部機能はプラン依存) | AI機能が有効なCloudとセルフホストで無料 |
Notionの開発者ドキュメントとAFFiNEのMCPページをもとに、2026年10月31日時点で比較しました。
一方で、データベースでの業務管理、外部サービスとの連携の多さ、書き込みまで含むツールの数はNotionのほうが充実しています。データベース中心の運用を続けるなら、無理に乗り換える必要はありません。Notion自体の移行を検討している場合は、セルフホストできるNotion代替ツールの比較も参考にしてください。
AFFiNEは「設定」→「Integrations」→「MCP Server」でクライアントごとの認証情報を作り、表示された設定をクライアントに貼り付けて接続します。ローカルのMarkdownを扱いたい場合はObsidian MCPの設定方法、ほかの選択肢は用途別のMCPサーバーおすすめで比較しています。
はい。Notion MCPはすべてのNotionプランで追加料金なしで使えます。ただし、MCPトークンはBusiness・Enterprise、外部ソース検索はさらにNotion AIの契約が必要で、レート制限もBusiness・Enterpriseのほうが高くなります。
Notionが推奨するStreamable HTTPでは https://mcp.notion.com/mcp を使います。クライアントがStreamable HTTPに対応していない場合だけ、https://mcp.notion.com/sse を使います。
使えます。NotionはChatGPTのアプリとして接続できます。任意のMCPサーバーを追加する開発者モードは一部のプランと管理者設定に限られるため、OpenAIの最新のヘルプを確認してください。
ホスト型サーバーはできません。オープンソース版の notion-mcp-server はインテグレーショントークンでローカル実行できますが、Notionは積極的な保守を終了したと明記しています。AIから使うナレッジ基盤を自社環境に置く必要がある場合は、セルフホスト環境でMCPを提供するAFFiNEのようなツールも検討できます。
Business・Enterpriseなら使えます。ワークスペースのオーナーが開発者ポータルでMCPトークンを作成し、クライアントがBearerトークンとして送ります。SAML SSOを使うEnterpriseでは、エンタープライズ管理型の認可も使えます。
できません。Notionのデータはページとデータベースで、キャンバス型の情報がないためです。AFFiNEのMCPサーバーはEdgelessキャンバス上のテキストをインデックス化し、要素とフレームの位置情報とともに返します。
Notion APIは、開発者がコードから使うREST APIです。Notion MCPはそのAPIの上に作られ、AIアシスタントが自分で見つけて呼び出せるツールとして機能を提供します。OAuthでログインするだけで使えるため、コードを書く必要はありません。
2026年10月31日に、developers.notion.comのNotion MCP概要、接続ガイドとFAQ、対応ツール一覧、セキュリティガイド、APIリクエスト制限を確認しました。あわせて、Notionヘルプセンターの管理者向け記事、makenotion/notion-mcp-serverのREADME、AnthropicとOpenAIのコネクタに関するヘルプも確認しています。設定例はこれらの公式資料から引用しました。今回の更新では各クライアントでの通し動作は試していないため、手順は公式資料で確認済みの内容として扱ってください。AFFiNEの情報はAFFiNE自身のMCPドキュメントに基づきます。図はAFFiNEが作成したものです。
Notion MCPは、https://mcp.notion.com/mcp を追加してOAuth認証するだけで、ClaudeやCursor、ChatGPTからNotionを扱えるようにする公式サーバーです。導入前に確認するのは、AIに見せる範囲(ログインするアカウント)、プランで使える機能、書き込み前の確認の3点です。図やホワイトボードにも意思決定が残っているチームは、AFFiNE MCPと併用してアシスタントに両方を渡してください。AIが参照できる範囲が、文書から図まで広がります。