NotebookLM CLIとは？ターミナルからNotebookLMを操作する新しい手段
CLI
- バッチ処理・自動化に最適
- エイリアスでUUID不要
- AIエージェント連携可能 (MCPサーバー内蔵)
- 出力フォーマット指定可能 (JSON)
- 向いているユーザー: 研究・開発で大量ソースを扱う人、シェルスクリプトに慣れたエンジニア
公式Web版
- ブラウザ上で自動ログイン
- 直感的なGUI操作
- ポッドキャストをたまに聞くだけのライトユーザー向け
- セットアップ不要
- 向いているユーザー: ライトユーザー
CLIがもたらす3つのメリット
室谷代表取締役NotebookLMにCLIが出てきたのは面白い流れですよね。ターミナルから全機能を叩ける。
バッチ処理や自動化を前提にすると、Web版より圧倒的に効率的です。
バッチ処理や自動化を前提にすると、Web版より圧倒的に効率的です。
テキトー教師.AI認定講師そうですね。最初に触ったとき「これ、全部コマンドで操作できるんだ」って驚きました。
特にnlm notebook listやnlm source addのような基本操作がシェルで完結するのは便利です。
特にnlm notebook listやnlm source addのような基本操作がシェルで完結するのは便利です。
室谷代表取締役うちの現場でも、研究データを毎日自動で取り込んで要約させる処理を組んでます。時給換算すると月間で何十時間分の手間が削減できてる計算。
ROIで考えれば導入しない手はないですね。
ROIで考えれば導入しない手はないですね。
テキトー教師.AI認定講師たしかに繰り返し作業には強い。加えてエイリアス機能でUUIDを覚えなくていい点も初心者には優しい。
公式Web版との違い
室谷代表取締役まず認証周りが違いますね。Web版はブラウザ上で自動ログインですが、CLIはnlm loginでChromeを起動してCookieを抽出する仕組み。
面倒に見えるけど一度設定すればキャッシュされます。
面倒に見えるけど一度設定すればキャッシュされます。
テキトー教師.AI認定講師実はここがハマるポイントで、「Chromeが開くの怖い」と感じる人もいます。でも公式なAPIじゃないので、この方式が今のところ確実なんですよ。
室谷代表取締役もう一つの違いは、CLIだとAIエージェントとの連携が容易なこと。MCPサーバーを内蔵しているので、Claude Codeから直接ノートブックを操作できる。
Web版ではできない芸当です。
Web版ではできない芸当です。
テキトー教師.AI認定講師あと、CLIは出力フォーマットを指定できるのも利点。JSONで取得して他のツールに渡したい場合には必須ですね。
どのようなユーザーに向いているか
室谷代表取締役まず間違いなく、研究や開発で大量のソースを扱う人。週に何度も新しいノートを作ったり、ポッドキャストを生成したりする現場にはCLIは必須です。
テキトー教師.AI認定講師それから、シェルスクリプトに慣れたエンジニア。バッチ処理やcronで定期的にノート内容をエクスポートしたい場合、Web版では無理ですからね。
室谷代表取締役逆に、「ポッドキャストをたまに聞くだけ」というライトユーザーにはWeb版で十分。CLIのセットアップコストを考慮すると、頻度が低いならWeb版の方が手軽でしょう。
テキトー教師.AI認定講師つまり用途と頻度で判断する、と。初心者でも「まずはWeb版で慣れてから、自動化が必要になったらCLIに移行する」という流れがいいと思います。
インストールと初回認証の手順
- 1パッケージマネージャを選択pip/pipx/uvから選択。pipx推奨、uvなら「uv tool install notebooklm-cli」一択。
- 2インストールpip install notebooklm-cli / pipx install notebooklm-cli / uv tool install notebooklm-cli
- 3初回認証: nlm loginChromeが起動し、Chrome DevTools ProtocolでCookieを自動取得。初回は時間がかかる。
- 4継続利用の注意認証は定期的にリフレッシュされないため、長時間放置すると再ログインが必要。
- 5複数アカウント切り替え (オプション)nlm auth --authuser N で切り替え。nlm notebook list で確認しながら作業。
uv/pip/pipxでのインストール方法
室谷代表取締役このCLI、Python製なんですよね。pipでもpipxでも入るし、最近だとuvも対応してる。
テキトー教師.AI認定講師そうそう。最初に「どのパッケージマネージャ使えばいいんだろう」って迷う人、結構いますよ。
室谷代表取締役俺はpipx推し。仮想環境汚さないし、ツール専用になる。
ただ、uvaristにはuv tool install notebooklm-cli一択ですね。
ただ、uvaristにはuv tool install notebooklm-cli一択ですね。
テキトー教師.AI認定講師はい。pip install notebooklm-cliでももちろん動きますけど、pipxやuvでグローバルに入れておくと、後々楽です。
Chrome DevTools Protocolを使った認証
テキトー教師.AI認定講師で、インストールできたら最初にやるのが
nlm login なんですけど、ここでChromeが起動して面食らう人が多いみたいです。室谷代表取締役あれ、Chrome DevTools ProtocolでセッションCookieを自動取得してるんですよ。手動でログインする手間はかかるけど、その後の操作が一気にスムーズになる。
テキトー教師.AI認定講師実はこれ、結構な量のCookieを抜くんで、初回は少し時間かかります。でも一回やってしまえば、あとは裏で勝手に認証通るようになる。
室谷代表取締役裏で定期的にリフレッシュされるわけじゃないから、長時間放置すると再ログインが必要になるケースもある。そこだけ注意。
複数アカウントのプロファイル管理
室谷代表取締役あと、Googleアカウントを複数持ってる人は
nlm auth --authuser N で切り替えられます。テキトー教師.AI認定講師これ便利ですよね。仕事用と個人用で使い分けたいときに。
室谷代表取締役実際の業務だと、クライアントごとに別アカウントで使いたい要件もある。profile指定でセッションを分けられるのは地味に効く。
テキトー教師.AI認定講師ただ、最初はどのアカウントが紐づいてるか混乱するので、
nlm notebook list で確認しながらやるのが無難です。NotebookLM CLIの全機能：ノートブック・ソース・生成・ダウンロード
ノートブック操作
作成・一覧・削除をコマンドで実行。UUIDの代わりにエイリアス使用可能。
ソース管理
URL・ファイル・テキスト・YouTubeのソース追加。stdinからの一括追加も可能。
コンテンツ生成
ポッドキャスト、ビデオ概要、スライド、クイズなどを生成。進行状況をポーリング可能。
エクスポート・ダウンロード
audio/video/report/slide_deck/infographicをダウンロード。Googleドキュメント等にもエクスポート。
ノートブックの作成・一覧・削除
室谷代表取締役まず基本的なノートブック操作から。CLIだと
これだけで管理の自動化が一気に進むんですよね。
nlm notebook create "プロジェクト名" で新規作成、nlm notebook list で一覧表示、削除は nlm notebook delete <id> と。これだけで管理の自動化が一気に進むんですよね。
テキトー教師.AI認定講師たしかに、Web版だと手動でポチポチやるしかない部分を、CLIならスクリプトに組み込めるのが大きいですね。最初に戸惑うのはUUIDの扱いですが、エイリアス機能があるので
myproject みたいな名前で参照できるんですよ。室谷代表取締役そこ重要ですね。複数のノートブックを毎回UUIDで指定するのは現実的じゃないので。
エイリアスを使えばバッチ処理の組み立ても楽になる。
エイリアスを使えばバッチ処理の組み立ても楽になる。
ソースの追加と管理（URL・ファイル・テキスト・YouTube）
室谷代表取締役ソース追加のコマンドは結構統一されてます。
YouTubeのURLもそのまま渡せば自動で文字起こしして取り込む。
nlm source add <notebook_id> --url "https://..." でURL、--text "内容" でテキスト、--file_path でローカルファイルと。YouTubeのURLもそのまま渡せば自動で文字起こしして取り込む。
テキトー教師.AI認定講師この辺はWeb版と同じ感覚で使えるんですが、CLIならではの強みが
stdin からの一括追加ですね。複数のURLを改行区切りで流し込んで、まとめてインポートできる。室谷代表取締役そう、そこが効く。
時給換算すると数分の作業が秒になる。
printf '%s\n' url1 url2 | nlm source add <id> - みたいな。時給換算すると数分の作業が秒になる。
オーディオやビデオなどのコンテンツ生成
テキトー教師.AI認定講師コンテンツ生成は
nlm studio create が中心で、タイプを指定するだけでポッドキャストやビデオ概要、スライド、クイズなどが作れます。室谷代表取締役具体的には
--type audio に --format deep_dive とか付けると深堀り討論形式のポッドキャストが生成される。studio_create に渡すパラメータで細かい制御も可能。テキトー教師.AI認定講師あとは生成の進行状況を
studio_status でポーリングできるのもCLIならではですね。Web版だとブラウザを開いて待つしかないけど、スクリプトで完了を検知して次の処理に進める。生成物のエクスポートとダウンロード
室谷代表取締役最終的にできあがったコンテンツは
download_artifact でローカルに落とせます。対応しているタイプが audio, video, report, slide_deck, infographic と幅広い。テキトー教師.AI認定講師さらに
export_artifact でGoogleドキュメントやスプレッドシートに直接エクスポートできるのも地味に便利です。レポートをそのまま共有ドキュメントとして展開できる。室谷代表取締役ダウンロードパスを指定しないと標準出力に出るので、リダイレクトでファイルに保存したり、パイプで別のツールに渡したり。現場の自動化パイプラインに組み込むのに最適なんですよね。
MCPサーバーとAIエージェント（Claude Code）との連携
- 1事前認証ターミナルで「nlm login」を実行し認証する
- 2Claude CodeにMCP追加「claude mcp add --scope user notebooklm-mcp notebooklm-mcp」を実行
- 3競合確認同名のMCPサーバーが既にある場合は削除してから追加する
MCPサーバーとしてのNotebookLM CLI
テキトー教師.AI認定講師NotebookLM CLI、実はMCPサーバーとしても動くんですよ。ターミナルで使うCLIがそのままAIエージェントから呼び出せる形になってる。
室谷代表取締役これ、設計がうまいんですよね。同じパッケージでCLIとMCPサーバーの両方を提供してて、
uv tool install notebooklm-mcp-cli 一発で両方入る。テキトー教師.AI認定講師最初に
nlm login で認証しておけば、あとはエージェント側からノートブックの作成やクエリ、ソース追加まで全部できる。39個のツールが使えるってMCPガイドに書いてありました。Claude Codeへの追加方法
室谷代表取締役Claude Codeから使いたいなら、
claude mcp add --scope user notebooklm-mcp notebooklm-mcp を叩くだけです。サーバー名は notebooklm-mcp 固定でいい。テキトー教師.AI認定講師注意点としては、もし以前に別のNotebookLM MCPを同じ名前で入れてると競合するので、古い方を削除してから入れる。
室谷代表取締役そうそう。Heremesとか複数エージェント使ってると混乱するらしい。
認証は先にCLIで済ませておけば、エージェント側では特に何もしなくていい。
認証は先にCLIで済ませておけば、エージェント側では特に何もしなくていい。
テキトー教師.AI認定講師これでClaude Codeが直接NotebookLMとやりとりできるようになる。同期の作業がぐっと楽になりますね。
CursorやCodexなど他のエージェントでの利用
テキトー教師.AI認定講師Claude Code以外にも、CodexやOpenClaw、Gemini CLIでも同じように使えます。設定手順は大体一緒。
室谷代表取締役各エージェントに応じてMCPの追加コマンドが違うだけですね。Gemini CLIなら
gemini mcp add になる。テキトー教師.AI認定講師エージェントごとに同じツールセットが使えるのは統一感があっていい。
スキル機能によるAIアシスタントの強化
室谷代表取締役CLIにはスキルフォルダも付いてて、エージェントのスキルとして直接読み込ませられる。Claude、Codex、OpenCodeなんかに対応してます。
テキトー教師.AI認定講師スキルとして登録すると、エージェントがNotebookLMの機能を「できること」として認識して、自然に使ってくれるようになる。
室谷代表取締役ターミナルで操作できる範囲が広がるので、研究の自動化とかバッチ処理に組み込みやすい。ROIで考えても、手動でWeb版をポチポチするより圧倒的に速い。
NotebookLM CLIとWeb版の使い分け方
Web版
- 誰でも使える手軽さ
- 50ソース/日50クエリの制限
- 手動アップロードの手間
- 生成待ち中の監視が必要
- ブラウザのみで利用可能
CLI
- pipx一発インストール
- 制限なし、大量処理可能
- スクリプトで自動化・放置可能
- エイリアスや--aiで簡単操作
- 複数ノートブック一括操作
Web版の制限とCLIの強み
室谷代表取締役Web版はブラウザさえあれば誰でも使える手軽さが魅力ですよね。ただ、50ソースまでとか1日50クエリまでという制限がある。
ここがボトルネックになるケースが多い。
ここがボトルネックになるケースが多い。
テキトー教師.AI認定講師たしかに、現場で「毎日大量の資料を読み込みたい」という人にはその壁が効いてきます。CLIならそういう制限を気にせず、内部API経由で一気に処理できる。
室谷代表取締役時給換算すると、手動で一つずつアップロードするコストが馬鹿にならないんですよ。特に同じフォルダから複数ファイルを一度に取り込みたいときは、CLI一発の方が圧倒的に安い。
テキトー教師.AI認定講師あと、Web版だと生成待ちの間ずっと画面見てなきゃいけないけど、CLIならスクリプトに任せて放置できる。その差は大きいです。
バッチ処理や自動化に向いているケース
室谷代表取締役例えば毎朝、特定のRSSから新しい記事をクロールして、自動でノートブックに追加して、その日のポッドキャストを生成する――全部ワンコマンドで完結します。
テキトー教師.AI認定講師複数のノートブックをまとめて操作したいときにも強いですね。シェルスクリプトでループを回せば、数百のノートブックを一気に処理できる。
室谷代表取締役うちの現場でも、研究レポートの下書きを毎週自動生成する仕組みを組んでます。最初のセットアップに数時間かかりましたが、その後はゼロ運用。
ROIで言うと、2週間で回収できました。
ROIで言うと、2週間で回収できました。
非エンジニアがCLIを使うためのポイント
室谷代表取締役CLIって聞くとエンジニア専用に思われがちですが、notebooklm-cliはインストールが簡単なんですよね。pipx一発で入る。
テキトー教師.AI認定講師コマンドの名前も「nlm notebook list」とか「nlm source add」って感じで、英語そのままなので覚えやすい。エイリアス機能でUUIDの代わりに「myproject」みたいな名前を付けられるのも地味に便利です。
室谷代表取締役エイリアスはだいぶ親切ですよね。あと、
コードを読まなくても対話形式で覚えられる。
nlm --aiって打つとAIが使い方を説明してくれる。コードを読まなくても対話形式で覚えられる。
テキトー教師.AI認定講師そうそう。最初は「ターミナル怖い」と思ってる人も、1回やってみれば「あ、これだけか」ってなるパターンが多いです。
セキュリティと注意点：内部API利用のリスク
非公式APIの利用に伴うリスク
室谷代表取締役NotebookLM CLI、めちゃくちゃ便利なんですけど、内部の非公式APIを叩いてるっていうリスクは認識しておいたほうがいいですね。
テキトー教師.AI認定講師たしかに、READMEにも「未文書化のAPIを使ってるから、いつ仕様変更で動かなくなるかわからない」って書いてありますね。Googleの公式ものじゃないから、サポートも当然ない。
室谷代表取締役そこが怖いところ。業務でガッツリ依存するのは正直リスキーです。
MYUUUでも実験用途には使ってますが、基幹ワークフローには組み込んでません。
MYUUUでも実験用途には使ってますが、基幹ワークフローには組み込んでません。
テキトー教師.AI認定講師まずは個人のリサーチやプロトタイプで使うのが無難でしょうね。何かあっても自己責任の範囲で。
認証情報の管理方法
室谷代表取締役認証はChromeのDevTools Protocolを使ってブラウザからクッキーを抽出する方式です。
nlm loginでChromeが起動して自動でやってくれます。テキトー教師.AI認定講師便利な反面、認証情報がローカルにキャッシュされるわけですよね。~/.nlmとかに保存されるんでしたっけ。
室谷代表取締役そうです。gitに誤って上げないように注意が必要です。
CIで使う場合も、環境変数でクッキーを渡す方法が用意されてます。
CIで使う場合も、環境変数でクッキーを渡す方法が用意されてます。
テキトー教師.AI認定講師そこはちゃんと設計されてますね。複数アカウントのプロファイル切り替えもできるから、使い分けもスムーズです。
レート制限と安定性
テキトー教師.AI認定講師ヘビーに使うとレート制限に引っかかることもあるみたいですね。プロジェクトのREADMEでも「Heavy usage may be throttled」と注意書きがあります。
室谷代表取締役非公式APIなので当然ですが、Google側の制限が厳しくなる可能性はあります。大量のノートブック作成や一括生成は控えたほうがいい。
テキトー教師.AI認定講師でも普段使い程度なら問題ないです。私は数十回のクエリで制限に当たったことはないですね。
室谷代表取締役安定性という点でも、Googleのアップデートで突然動かなくなるリスクは常につきまとう。使うならその前提で計画しましょう。
よくある質問
Q1. NotebookLM CLIは公式ツールですか？
室谷代表取締役非公式なんですよね。内部APIを叩くサードパーティ製のラッパーで、Anthropicが公式にサポートしているわけじゃないんですよ。
テキトー教師.AI認定講師そうです。非公式ゆえに、突然APIが変わって使えなくなるリスクは認識しておいたほうがいいですね。
ただ、現時点ではかなり安定して動いています。
ただ、現時点ではかなり安定して動いています。
Q2. CLIでできることとできないことの境界は？
テキトー教師.AI認定講師現場でよく聞かれるのが「Web版と同じ生成結果が得られるか」という点です。実は微妙に品質が違うケースがあるんですね。
室谷代表取締役ああ、それあります。特に長文のフォーマット指定をするとCLI側で崩れやすい印象です。
逆にソースの追加・削除といった管理系操作はCLIの方が高速ですね。
逆にソースの追加・削除といった管理系操作はCLIの方が高速ですね。
Q3. Windowsでも動作しますか？
室谷代表取締役Pythonベースなので理論上は動くはずですが、認証周りのパス設定でハマる人が多いみたいです。
テキトー教師.AI認定講師実際にWindowsでセットアップした方から「WSLを使えば問題なかった」という声を聞きます。どうしてもネイティブでやるなら環境変数の設定を丁寧にやる必要がありますね。
Q4. エラーメッセージがよくわからないのですが、どう対処すればいいですか？
室谷代表取締役よくあるのが「403 Forbidden」ですね。これは認証トークンの期限切れか、内部APIの変更が原因です。
テキトー教師.AI認定講師まずはブラウザで再認証してみてください。多くの場合それで直ります。
tokenファイルを削除して再実行するのが確実です。
tokenファイルを削除して再実行するのが確実です。
Q5. 他のノートブックCLI（oaiなど）とどう違いますか？
室谷代表取締役公式のoai CLIと比べると、NotebookLM CLIはソース管理やノートブックの構造操作に特化しているのが特徴ですね。
テキトー教師.AI認定講師用途が全然違うので、両方をインストールしておいて、NotebookLMの機能が必要なときだけこちらを使う、という使い分けが現場では一般的です。
まとめ
室谷代表取締役まとめると、NotebookLM CLIは非公式ながら非常に実用的なツールですね。特にバッチ処理やCI/CDに組み込みたいチームには強力な選択肢です。
テキトー教師.AI認定講師そうですね。初めての人はまずインストールして、
エラーが出ても慌てず、認証をリセットすれば大抵動きます。
notebooklm listとnotebooklm generateを試してみるといいです。エラーが出ても慌てず、認証をリセットすれば大抵動きます。
室谷代表取締役ただ、本番運用に使うならAPI変更のリスクを考慮して、定期的に動作確認する仕組みは必要です。
テキトー教師.AI認定講師ええ。個人の実験用としては十分コスパがいいので、まずは触ってみてNotebookLMの可能性を体感してほしいですね。
