NotionとClaude Codeを連携させた話【MCP実録】

NotionとClaude CodeをMCPで連携させると、AIがNotionを直接読み書きできる状態になります。ページ作成・検索・更新がプロンプト一発で動く、実用的な自動化の入り口です。

Notion Claude MCPとは？なぜ今注目されているのか？

MCP（Model Context Protocol）とは、Anthropicが2024年11月に公開したオープン規格で、AIモデルが外部ツールやデータソースと双方向にやり取りするための「共通言語」です。これまでAIはチャット画面の中だけで完結していましたが、MCPを使うことでNotionやSlack、GitHubといった実業務ツールを直接操作できるようになります。

Notionは現在、国内でも急速に導入が進んでおり、2024年時点でグローバル利用者数は4,000万人を超えています。ドキュメント管理・タスク管理・データベースを一元化できるNotionに、Claude Codeというコーディング特化のAIエージェントが接続されると何が起きるか。答えは「AIがNotionを手足のように使える」状態になることです。

具体的には次のような操作がプロンプトひとつで実行できます。

• 指定した条件でNotionデータベースを検索し、結果を返す
• 新しいページを作成してテンプレートを流し込む
• 既存ページのプロパティを一括更新する
• 複数ページをまたいだ情報を収集してサマリーを生成する

単なる「チャットでNotionについて質問できる」ではなく、AIが実際にNotionのAPIを叩いて操作する点が最大の違いです。

実際にどう動くのか？私が試したセットアップの全手順は？

私が実際にNotionとClaude CodeをMCP連携させたのは2025年3月のことです。独立直後で業務委託の契約書管理やタスクの進捗管理をNotionで行っていた時期で、「毎回Notionを手動で開いて更新する」という作業コストを削りたいという実用的な動機からスタートしました。

セットアップの手順は大きく4ステップに分かれます。

1. Notion Integration（インテグレーション）の作成
   Notion公式サイトの「My integrations」からインテグレーションを新規作成し、APIキーを取得します。このキーがMCPサーバーとNotionをつなぐ認証情報になります。
2. 対象ページ・データベースへのアクセス許可
   連携したいNotionのページまたはデータベースを開き、右上の「…」メニューから「Connections」でさきほど作ったインテグレーションを追加します。ここを忘れると「ページが見つからない」エラーになるので注意が必要です。
3. MCPサーバーのインストールと設定
   Notion公式が提供する`@notionhq/notion-mcp-server`をnpxで実行します。Claude Codeの設定ファイル（`claude_desktop_config.json`または`.claude/settings.json`）に以下のような記述を追加します。

   サーバー名を`notion`とし、コマンドに`npx`、引数に`-y`と`@notionhq/notion-mcp-server`を指定、環境変数`NOTION_API_KEY`に取得したAPIキーを設定する構成です。JSONの記述そのものはシンプルですが、インデントやカンマの位置でエラーが出やすいため、エディタのJSONバリデーターで確認してから保存することを強く勧めます。

4. Claude Codeの再起動と動作確認
   設定ファイルを保存したらClaude Codeを再起動します。プロンプトで「Notionの〇〇データベースを検索して」と入力し、ツール呼び出しが走れば連携成功です。私の環境では初回起動後、ツール一覧に`notion_search`や`notion_create_page`などが表示されたことで動作を確認できました。

セットアップにかかった時間は約30分。詰まったのはステップ2のアクセス許可で、インテグレーションを作っただけではAPIキーがあっても対象ページにアクセスできないという仕様を見落としていたためです。

実務でどう使っているのか？具体的なユースケースは？

セットアップが完了してから、私の日常業務での使い方は主に3パターンに落ち着いています。

パターン1：週次レポートの自動生成

業務委託先のHinotoriでは毎週月曜に前週の活動サマリーを提出しています。以前はNotionの複数ページを手動で見て回り、WordかNotionのページにまとめ直すという作業に30〜40分かかっていました。現在はClaude Codeに「先週更新されたタスクページを全部引っ張ってきてサマリーを作って」と指示するだけで、5分以内に下書きが出来上がります。週4回の作業換算で月に約2時間の削減です。

パターン2：案件管理データベースへの一括入力

新しいクライアントとの契約が決まると、Notionの案件管理データベースに会社名・担当者名・契約形態・開始日などを入力する必要があります。メールや契約書PDFの内容をClaudeに貼り付けて「Notionの案件データベースに登録して」と指示すると、必要なプロパティを読み取って自動入力してくれます。手入力ミスが減り、入力作業自体がほぼゼロになりました。

パターン3：タスクのステータス一括更新

週末に完了したタスクをまとめて「完了」ステータスに変更する作業も、従来は一件ずつクリックしていました。現在は「今週完了した以下のタスクのステータスをDoneに変更して」とリストを渡すだけで処理が終わります。

ハマりやすいエラーと対処法は？

MCP連携は設定が一箇所でも崩れると動かないため、トラブルシューティングの知識が欠かせません。私が実際に遭遇したエラーと、その解決方法をまとめます。

特に多いのが「object not found」と「MCPサーバーがツール一覧に出ない」の2パターンです。前者はNotionの権限設定の見落とし、後者はJSON構文エラーがほとんどです。Claude Codeの開発者ツール（ログ画面）でエラーメッセージを確認する習慣をつけると、原因特定が格段に速くなります。

また、Notion MCPはAPIバージョンによって使えるツールの種類が変わることがあります。`@notionhq/notion-mcp-server`のバージョンを固定せずにnpxで実行していると、アップデートで動作が変わる可能性があるため、本番運用ではバージョンを明示することを推奨します。

Claude CodeとNotionのMCP連携、今後の発展可能性は？

現時点でのNotion MCPはすでに実用レベルですが、いくつかの制限も存在します。たとえばNotionの「リレーション」プロパティ（ページ間の関連付け）の操作はAPIの制約でやや扱いづらく、複雑なデータベース構造では意図した動作をしないケースがあります。また、Notionの「ブロック」単位の細かい編集（特定の段落だけを書き換えるなど）は、現在のMCPツールでは精度が安定していません。

一方で、Anthropicは2025年に入ってからMCPの仕様を急速にアップデートしており、ツールの種類・精度ともに改善が続いています。Notionも公式でMCPサポートを強化しており、今後は「Claude CodeがNotionのデータを元に自律的に複数のタスクをこなす」ようなエージェント的な使い方がより現実的になってくるはずです。

私が現在試しているのは、freeeの会計データとNotionのプロジェクト管理データをClaude Codeで横断的に処理するフローです。請求書の発行タイミングをNotionのタスク完了ステータスと連動させ、Claude Codeが必要に応じてfreee側の処理をトリガーするという構成で、複数MCPを組み合わせた実用化の一歩手前まで来ています。

NotionとClaude Codeを連携させる最大の価値は、「AIがデータを見るだけでなく動かせる」点にあります。チャットで情報を教えてもらうレベルから、AIが業務システムの一部として機能するレベルへ。MCPはその入り口として、文系・非エンジニアでもセットアップできる現実的な選択肢になっています。

セットアップのハードルは「Notionのインテグレーション設定」と「JSON設定ファイルの記述」の2点だけです。プログラミングの知識がなくても、手順を一つひとつ確認しながら進めれば30分で動作確認まで到達できます。まず小さなデータベース一つから試してみることが、AI自動化の実感を得る最短ルートです。

よくある質問（FAQ）