設定方法
MCP は、お使いの対応アプリ(クライアント)に下記の設定を貼り付けて使います。 タブからアプリを選び、表示された設定をコピーしてください。
Claude Desktop / Claude Code: Claude Desktop(公式デスクトップアプリ)と Claude Code(公式CLI)は同じ JSON を使います。Desktop は設定ファイルに貼り付け、Claude Code は `.mcp.json` に記述するか `claude mcp add` で追加します。
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
}
}
}
Cursor: AI 機能を内蔵したコードエディタ(`~/.cursor/mcp.json` に記述)
{
"mcpServers": {
"notion": {
"url": "https://mcp.notion.com/mcp"
}
}
}
Cline: VS Code に追加する AI アシスタント拡張(設定画面の MCP Servers から記述)
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
}
}
}
Gemini CLI: Google の AI CLI。設定形式は Claude Desktop と同じで、`~/.gemini/settings.json` の `mcpServers` に記述するか `gemini mcp add` で追加します。
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]
}
}
}
OpenAI Codex: OpenAI の CLI/IDE。設定は TOML 形式で `~/.codex/config.toml` に記述します(下記は左の JSON から自動変換した参考値です)。
[mcp_servers.notion]
command = "npx"
args = ["-y", "mcp-remote", "https://mcp.notion.com/mcp"]VS Code: VS Code(GitHub Copilot のエージェント)。`mcp.json` の `servers` キーに記述します(下記は左の JSON から自動変換した参考値です)。
{
"servers": {
"notion": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://mcp.notion.com/mcp"
]
}
}
}※ Gemini CLI は Claude Desktop と同じ mcpServers 形式のため同一の JSON を表示しています。Codex / VS Code タブの設定は、上記 JSON を各公式スキーマ(Codex=~/.codex/config.toml の TOML 形式 / VS Code=mcp.json の servers キー)へ 自動変換した参考値です。貼り付け前にお使いのバージョンの公式ドキュメントもご確認ください。
Notion とは
Notion は、文書・データベース・タスク・Wiki・カレンダーを一つにまとめられる多機能ノートアプリです。「メモアプリ」「Excel/スプレッドシート」「タスク管理ツール」「社内 Wiki」を 1 つのワークスペースで全部こなせるのが最大の特徴で、個人の知識管理から企業の社内ドキュメントまで幅広く使われています。
ページ同士をリンクで繋いだり、データベースで構造化したり、ブロックを自由に組み合わせたりできる柔軟性が魅力で、「とりあえず Notion に書いておく」がスタンダードになっているチームも多いです。プロダクトドキュメント・議事録・タスク管理・採用情報・社内ナレッジなど、業務文書の中心ハブとして機能します。
これは Notion 公式のツールです。
Notion × AI でできること
この MCP サーバーを導入すると、Notion のページ操作を AI への一言で実行できます。
📝 議事録を保存
「この会議の議事録を『会議メモ』DB に新しいページとして追加して」
→ 議事録を構造化ページとして自動保存
🔍 DB から検索
「『タスク管理』DB で未着手のタスクを期限順に一覧化して」
→ フィルタ + ソート付きで取得
✨ 内容を整理
「ページ ID xxxxx の内容を日本語で要約して新ページに保存して」
→ 既存ページ参照 + 要約 + 保存
📊 レポート生成
「先週追加されたタスクから進捗レポートを作って」
→ DB クエリ + 集計 + レポート化
提供される主なツール
リモート版(推奨)の主なツールを、機能カテゴリ別にまとめます:
| 機能カテゴリ | 主なツール |
|---|---|
| 検索 | notion-search(ワークスペース内のページ・データベース・ユーザーを検索)/ notion-ai-search(Notion AI が使えるワークスペースで、接続済みの Slack・Google ドライブなども横断検索) |
| 内容の取得 | notion-fetch(ページ・データベース・ビューの内容を URL または ID で取得) |
| ページ操作 | notion-create-pages / notion-update-page / notion-move-pages / notion-duplicate-page |
| データベース操作 | notion-create-database / notion-update-data-source / notion-query-data-sources(絞り込み・並べ替えつきの読み取り)/ notion-create-view / notion-update-view |
| コメント | notion-create-comment / notion-get-comments |
| ユーザー・チーム | notion-get-users / notion-get-teams |
| ファイル | notion-create-file-upload(20MiB まで)/ notion-create-attachment / notion-download-attachment |
| 会議メモ | notion-query-meeting-notes(Business プラン以上かつ Notion AI が必要) |
このほか、Notion Skills やカスタムエージェントを扱うツールもあります。検索の詳細な絞り込み(編集者・最終編集日など)は Business / Enterprise プランが対象で、それ以外のプランでは一部の機能に利用量の上限があります。最新の一覧は Notion 公式の対応ツール一覧 で確認できます。
ローカル npm 版はツール構成が異なり、Notion API に対応した 24 ツール(post-page / patch-page / query-data-source / retrieve-page-markdown など)を提供します。
「ページの中身を作る」「DB に情報を蓄積する」「検索する」というナレッジ管理の基本動詞がすべて揃っています。
Notion MCP Server について
Notion MCP Server は、Notion 社が公式に提供する MCP サーバーです。リモート型(mcp.notion.com/mcp)とローカル npm 版(@notionhq/notion-mcp-server)の 2 形態で配布されており、Notion 公式はリモート型を推奨しています(ローカル版は「積極的な保守は行っていない」と案内)。本ページの設定例もリモート型を推奨経路として記載しています。
リモート型は OAuth 認証で接続するためAPI トークンの手動発行は不要で、初回接続時にブラウザで Notion にログインするだけで利用開始できます。ツールは AI エージェント向けに、ページを Markdown で編集できるなどトークン消費を抑える設計になっています。
スペック
- 配布形態: リモート型 MCP サーバー(Notion 管理)+ ローカル npm 版(
@notionhq/notion-mcp-server) - エンドポイント:
https://mcp.notion.com/mcp(streamable HTTP・推奨)/https://mcp.notion.com/sse(SSE・streamable HTTP に対応していないクライアント向け) - 認証: OAuth 2.1(ブラウザ)/ ローカル版は Bearer Token
- 提供元: Notion 社(公式)/ MIT
- 対応範囲: 検索 / ページ / データベース / コメント / ユーザー / ファイル ほか
- 公式ドキュメント: developers.notion.com/guides/mcp/get-started-with-mcp
導入手順
前提条件
- Notion アカウント(無料プランから利用可能)
- Node.js(
mcp-remoteブリッジ経由の場合)
ステップ(リモート版・推奨)
- ページ上部のタブから使用環境を選択し、JSON 設定をコピー
- コピーした JSON を設定ファイル(claude_desktop_config.json など)に追記して保存
- クライアントを再起動
- AI に「Notion に接続して」と話しかけると、ブラウザで OAuth 認証画面が開きます
- Notion アカウントでログインして、接続するワークスペースを選んで許可
接続後、AI は選んだワークスペースの中で、あなた自身が閲覧・編集できる内容を読み書きできます。ページ単位で範囲を絞る仕組みではない点に注意してください。
ローカル npm 版を使う場合(互換性向け)
{
"mcpServers": {
"notion": {
"command": "npx",
"args": ["-y", "@notionhq/notion-mcp-server"],
"env": {
"NOTION_TOKEN": "<YOUR_NOTION_API_TOKEN>"
}
}
}
}
Notion のインテグレーション設定 で Internal Integration を作成し、API トークンを発行する必要があります。あわせて、インテグレーション設定の「Access」タブで、AI に使わせるページ・データベースを接続してください。
注意事項
- 公式はリモート版(
mcp.notion.com/mcp)を推奨しています。新規導入はリモート版を推奨します(ローカル npm 版は、公式が「積極的な保守は行っていない」と案内)。 - リモート版は OAuth 認証を使用するため、API トークンの管理が不要です。AI は、あなたが閲覧・編集できる範囲の内容にアクセスします。
- ローカル版を使う場合、API トークンはソースコードやチャット履歴に含めないよう注意してください。
- リクエスト数には上限があります。1分あたり Business / Enterprise プランは600回、それ以外のプランは180回(平均で1秒3回)で、
notion-searchはさらに1分30回までです。上限に達したら、同時に行う検索や操作を減らすよう AI に指示するか、時間をおいて再実行してください。 - アクセスできない場合は、あなた自身の Notion アカウントでそのページを閲覧できるか、正しいワークスペースで認証したかを確認してください。
主なユースケース
- 「この会議の議事録を Notion の『会議メモ』DB に追加して」と頼むだけで、議事録が構造化されたページとして自動保存される
- 「『タスク管理』DB で未着手のタスクを期限順に一覧化して」と聞くと、AI が DB を検索して優先順位付きで返してくれる
- 「ページ ID xxxxx の内容を日本語で要約して新しいページに保存して」と既存ドキュメントの要約・整理を AI に任せられる
- 「先週追加されたタスクから進捗レポートを作って」と Notion の情報を素材に AI がレポート生成してくれる
プラットフォーム別の注意事項
- WindowsWindows 環境(WSL2 含む)でも `npx mcp-remote` コマンドで動作します。`npx` を使うため Node.js が必要です。
セットアップ・利用上の注意
- 認証初回接続時にブラウザで Notion アカウントへの OAuth 認証が求められます。API トークンの手動発行は不要です。現時点では、ブラウザでの認証を経ない自動接続には対応していません。
- リモート版・別の接続方法ローカル npm 版(`@notionhq/notion-mcp-server`)も利用可能です。ただし Notion 公式はリモート版(mcp.notion.com/mcp)を推奨しており、ローカル版については「積極的な保守は行っていない」「将来提供を終える可能性がある」と案内しています。