気になったWebページやYouTube動画を見つけるたびに、ブラウザでGemini Notebookを開いてURLを貼り付ける。この作業を、ふだん使っているAIエージェントに任せられたらと思ったことがあるなら、答えが出た。Googleが、Gemini Notebookを外部から操作するための公式APIとMCPサーバーを公開した。Claude CodeやCursorのようなコーディングエージェントから、ノートブックの作成やWebページ・YouTube動画の取り込みを直接呼び出せるようになる。どこまで自動化でき、何が必要になるのか。公式ドキュメントを順に確かめた。
公式APIとMCPサーバーが登場
Gemini Notebookは2026年7月、NotebookLMから名前を変えたAIノートサービスだ(Impress Watch)。手元の資料を読み込ませて質問できるこのサービスに、外部のプログラムやAIエージェントから直接アクセスできる窓口が加わった。
この窓口は、REST APIという形と、AIエージェントが外部のサービスを呼び出すときに使う共通の規格でも提供されている。後者はMCP(Model Context Protocol)と呼ばれる。Claude CodeやCursorが外部のアプリを操作するときの橋渡し役になる(developers.google.com/notebook/docs)。どちらも「early access Public Preview」、つまり正式提供前の早期プレビュー段階にある。
できることは、ノートブックの作成・一覧表示・名前の変更と、そこへの資料(ソース)の追加だ。追加できるソースは、WebページのURL、YouTube動画のURL、貼り付けたテキスト、Markdownの4種類になる(クイックスタート)。追加したソースは裏側で非同期に処理され、状態は「処理中(PROCESSING)」から「利用可能(ACTIVE)」、または「失敗(FAILED)」に変わる。
個人アカウントでの認証が必要
試しに、ふだんのgcloud auth print-access-tokenで取れるアクセストークンをそのままAPIに渡すと、エラーで弾かれる。公式ドキュメントが前提条件として挙げる手順を踏んでいないと、こうなる。
Gemini Notebook APIを呼ぶには、通常のGoogleログインとは別の手続きが要る。OAuth 2.0でcloud-platformとnotebookという2つのスコープを指定し、あらためてログインし直す必要がある(クイックスタート)。さらに、使うアカウントで一度はブラウザからnotebook.google.comへサインインしておく必要もある。これを済ませていないと、ノートブックの作成が「アカウントが見つからない」という404エラーになる。
この2段階さえ踏めば、有効期間1時間のアクセストークンでAPIを呼び出せるようになる。てっきりAPIキーを1つ発行するだけで済むと思っていたが、実際に必要だったのはOAuthのスコープ指定とブラウザでの事前サインインという二重の手続きだった。
この記事が当てはまるのは個人のGoogleアカウントの利用者だ。Google Workspaceアカウントは、現時点のプレビューでは403 PERMISSION_DENIEDで拒否され、使えない(クイックスタート)。あわせて、Google Cloudのプロジェクトでnotebook.googleapis.comを有効にしておく必要もある。
AIエージェントから呼び出す
ここまでの手順を踏めば、Claude CodeやCursorのようなMCP対応のコーディングエージェントから、Gemini Notebookを直接操作できる。MCPサーバーのエンドポイントはhttps://notebook.googleapis.com/mcpで、用意されているツールは7つだ(MCPのページ)。
| ツール | できること |
|---|---|
create_notebook | ノートブックを新規作成する |
get_notebook / list_notebooks | ノートブックの情報を取得・一覧表示する |
update_notebook | ノートブックの表示名を変える |
create_source | Webページ・YouTube動画・テキスト・Markdownを取り込む |
get_source / list_sources | ソースの処理状態を確認する |
この表が示すのは、ノートブックの出し入れを一通りエージェントに任せられる範囲の広さだ。Claude Codeの場合、設定はコマンド1行で済む。
claude mcp add gemini-notebook-api \
--transport http https://notebook.googleapis.com/mcp \
--header "Authorization: Bearer $ACCESS_TOKEN" \
--header "x-goog-user-project: $PROJECT_ID"
これを一度実行すれば、以後は「このページをGemini Notebookに追加して」と指示するだけでよい。URLの貼り付けから取り込み状況の確認まで、エージェントが代わりにこなす。Cursorも、設定ファイル.cursor/mcp.jsonに同じURLとヘッダーを書くだけで同様に使える(MCPのページ)。
まだ質問には答えられない
今の時点でできないことも、はっきりしている。ノートブックに追加した資料について、質問して回答を得る機能はAPIにまだない。できるのは資料を投入するところまでで、実際に読んで答えさせる作業は、今のところGemini Notebookの画面を開いて自分で行うことになる。
ほかにも、次はいずれもロードマップに挙がっているだけで、具体的な対応時期は示されていない(ロードマップ)。
- ソース・ノートブックの削除
- PDFなどバイナリファイルのアップロード
- Google DriveやGoogleドキュメントのURLをソースにすること
- 音声概要などの生成物の作成
早期プレビューという位置づけどおり、できることはこれから広がっていく段階にある。
まとめ
Googleは、Gemini Notebook(旧NotebookLM)を外部から操作できる公式API・MCPサーバーを公開した。対象は、今のところ個人のGoogleアカウントに限られる。
Claude CodeやCursorなどのAIエージェントから、ノートブックの作成を直接呼び出せるようになった。Webページ・YouTube動画・テキストの取り込みも同様だ。これで、資料集めの手作業を減らせる。
使うにはOAuthの2つのスコープとブラウザでの事前サインインが必要で、対象は今のところ個人アカウントに限られる。ノートブックへの質問応答や削除までは対応していないが、取り込みの自動化という最初の窓口はもう使える。
コメント
気づきや感想をどうぞ記事への補足や、読んで考えたことをお寄せください。個人情報や、他の人を傷つける内容の投稿はお控えください。
投稿にはGoogleログインが必要です。
Googleでログイン投稿にはGoogleアカウントの表示名が公開されます。メールアドレスは取得・公開しません。
コメントを読み込んでいます…