TerminalからGoogle NotebookLMに直接接続してClaudeやCursorと連携する方法

Google NotebookLMサービス(最近Gemini Notebookに改名)は、大量のドキュメント、長いPDF、YouTube動画を手軽に扱えます。ソースへの引用付きで首尾一貫した回答を生成し、2人のバーチャルホストが楽しいオーディオポッドキャストを作成することもできます。
このサービスの面倒な点は、公式の公開APIがまだないことです。
ターミナルからノートブックにリンクのバッチをアップロードしたり、生成された素材をエクスポートしたり、CursorのAIエージェントに個人のナレッジベースを検索させたりしたい場合は、ブラウザをクリックし続けるしか方法がありません。開発者のjacob-bdはこの問題を解決し、gemini-notebook-mcp-cliをリリースしました。コマンドラインインターフェースnlmを提供し、コードエディタへの接続用のローカルMCPサーバーを起動します。
このユーティリティできること
このリポジトリは2つのツールを組み合わせています:クラシックなCLI(bashスクリプト用)とMCP(Model Context Protocol)サーバーです。
ターミナルコマンドnlmを通じて、ブラウザタブを開かずにノートブックを管理できます。利用可能な操作には、メモの作成、ソースのアップロード、データベースへのクエリ、アーティファクトのエクスポートが含まれます:
# Создаем блокнот под ресерч
nlm notebook create "Архитектура проекта"
# Добавляем ссылки и документы
nlm source add <notebook-id> --url "https://habr.com/..."
# Запускаем генерацию аудиообзора
nlm audio create <notebook-id> --confirm
# Скачиваем все созданные материалы в папку
nlm download all <notebook-id> -d ./exports
最も興味深い部分は、MCPのセットアップ時に始まります。このパッケージは популярныеツール(Claude Code、Claude Desktop、Cursor、Gemini CLI、Windsurf、Cline)の設定ファイルに自動的に自身を登録できます。
クイックセットアップコマンド:
nlm setup add cursor
nlm setup add claude-code
その後、アシスタントチャットでプレーンテキストで記述できます:「分散トランザクションについてのノートブックを作成し、このプルリクエストを追加して、簡単なサマリーを生成してください。」アシスタントは舞台裏で必要な関数を呼び出します。
隠されたスタジオ機能
通常のテキスト回答に加えて、このツールはGemini Notebookのコンテンツジェネレーターへのアクセスを提供します。CLIとMCPを通じて、以下を実行できます:
- ポッドキャスト作成(2人のスピーカーによるトピックの詳細な議論)。
- さまざまな長さやビジュアルスタイルのビデオ概要生成。
- フラッシュカードと学習ガイドの組み立て。
- アップロードしたソースに基づくインフォグラフィックとマインドマップ。
- プレゼンテーションスライドの作成と編集。
嬉しいボーナス:コンソールまたはコードエディタから送信されたすべてのリクエストは、GoogleのWebインターフェース履歴に保存されます。ターミナルでクエリを開始し、夜に電話でブラウザから回答を読み続けることができます。
内部での認証のしくみ
公式APIがないため、このプロジェクトはGoogleの内部エンドポイントを通じて動作します。認証済みセッションからの有効なCookieが必要です。
プロジェクト開発者はこのプロセスを自動化しました。次のコマンドを実行します:
nlm login
ユーティリティは別のブラウザプロファイル(Chrome、Brave、Arc、Edge、Chromium、Firefoxがサポートされています)を開き、Googleアカウントにログインすると、スクリプトが必要なトークンを傍受してローカルに保存します。
このツールは、--profile workまたは--profile personalフラグ 통해複数のプロファイルでの作業をサポートしています。CSRFトークンはリクエストが失敗したときに自動的に更新され、Cookie自体は2〜4週間有効です。
正直な作成物語とコミュニティサポート
プロジェクト作者はREADMEで、深いPythonの経験なしにAIアシスタントを積極的に活用して最初のバージョン написал坦白了。
コードは即座のニーズを解決しましたが、理想的からは程遠いものでした。作者はそれを避けず、直接コミュニティにリファクタリングとコードレビューで助けを求めました。
オープンソースは意図通りに機能しました。数十人の開発者がプロジェクトに参加しました。彼らは接続プール、適切なエラー処理、WSL2サポート、Google Drive同期、バッチ操作、ログへの認証情報の漏洩を防ぐセキュリティ監査を追加しました。その結果は、GitHubでほぼ6000個のスターを獲得した信頼性の高いツールです。
注意点
ユーティリティをパイプラインに統合する前に、いくつかの制限に注意してください。
第一に、文書化されていないAPIの使用には破損のリスクが伴います。Googleはいつでもリクエスト形式やレスポンス構造を変更でき、スクリプトはパッチがリリースされるまで動作しなくなります。
第二に、免费アカウントには1日あたり約50リクエストの制限があります。バッチスクリプトで一度に100件のドキュメントを実行したい場合は、その上限に達します。
第三に、サーバーは43個の個別のMCPツールを公開しています。この数の関数は、Claude CodeやCursorのコンテキストウィンドウを заметно埋めます。現在ノートブックを扱っていない場合は、設定でサーバーを一時的に無効にするか、必要なメソッドのみを選択的にエクスポートするように構成することをお勧めします。
インストール
ユーティリティをインストールする最も簡単な方法は、uvパッケージマネージャーを使用することです:
uv tool install notebooklm-mcp-cli
標準的なPythonを使用している場合、pipxまたは通常のpipが動作します:
pipx install notebooklm-mcp-cli
永続的なインストールなしで実行する(uvxを使用)も利用可能です:
uvx --from notebooklm-mcp-cli nlm --help
誰が役立つのか
このプロジェクトは、Gemini Notebookを大規模なテキスト、技術ドキュメント、講義の分析に積極的に使用しているが、ブラウザのルーティンに厌倦している人々にアピールします。このユーティリティは、資料収集の自動化、サマリーエクスポートスクリプトの作成、Google DriveからのコンテキストをAIアシスタントとの作業チャットに直接統合するのに最適です。
関連プロジェクト