jacob-bd/gemini-notebook-mcp-cli

Programmatic access to Gemini Notebook - via command-line interface (CLI), Model Context Protocol (MCP) server, and AI agent skills.

gemini‑notebook‑mcp‑cli

何であるか – Pythonパッケージであり、コマンドラインツール（nlm）とModel-Context-Protocol（MCP）サーバー（notebooklm-mcp）を提供します。これにより、Google Gemini Notebook（旧称：Google NotebookLM）をプログラムで制御し、Claude、Cursor、Gemini-CLIなどのAIエージェントに同じ機能を公開できます。

なぜ重要か – Gemini NotebookはGoogleの個人知識ベースサービスで、ノートブック、ソース、オーディオ/ビデオ「スタジオ」アーティファクト、インタラクティブレポートを保存できます。安定したCLIとMCPエンドポイントを提供することで、このプロジェクトはスクリプト、CIパイプライン、またはMCPプロトコルを話す他のAIアシスタントからもノートブックを利用可能にします。

クイックスタート（3つのコマンド）

インストール – uv tool install notebooklm-mcp-cli（または pip install notebooklm-mcp-cli）。
ログイン – nlm login（ブラウザを開き、Googleのクッキーを抽出して保存します。OSのキーチェーンで暗号化することも可能です）。
ツールの接続 – nlm setupはインタラクティブなウィザードを実行し、ローカルのAIツール（Claude、Cursor、Gemini-CLI、Copilotなど）を検出し、MCPサーバーをそれらに登録します。

コア機能

機能	CLIコマンド	MCPアクション（エージェントに公開）
ノートブック一覧	`nlm notebook list`	`notebook_list`
ノートブック作成	`nlm notebook create "My Project"`	`notebook_create`
ソースの追加（URL、テキスト、Driveファイル）	`nlm source add <nb> --url …`	`source_add`
ノートブッククエリ（Web UIに追加）	`nlm notebook query "…"`	`notebook_query`
チャットセッション管理	`nlm chats list/get/export`	`chat_list`, `chat_get`, `chat_export`
スタジオコンテンツ生成（オーディオ、ビデオ、スライド）	`nlm studio create …`	`studio_create`
アーティファクトのダウンロード	`nlm download <type> …`	`download_artifact`
バッチ／パイプラインワークフロー	`nlm batch …`, `nlm pipeline run`	`batch`, `pipeline`
タグ付けとスマート選択	`nlm tag add/list/select`	`tag`
使用状況／クォータ情報	`nlm usage`	`usage_get`
認証情報保護	`nlm auth storage set protected`	–

エージェントの使い方

MCPサーバーの実行 – notebooklm-mcpでローカルHTTPエンドポイントを起動します。
エージェント登録 – ウィザード（nlm setup add <tool>）が、対象のAIツール（Claude Desktop、Cursorなど）にJSON設定を書き込みます。
自然言語呼び出し – 登録後、エージェントに「量子コンピューティングに関するノートブックを作成し、ポッドキャストを生成して」と尋ねられます。エージェントはこのリクエストをMCP呼び出し（notebook_create、studio_createなど）に翻訳し、サーバーがGemini Notebookに代わって操作します。

インストール方法

方法	コマンド
uv（推奨）	`uv tool install notebooklm-mcp-cli`
uvx（インストールなしで実行）	`uvx --from notebooklm-mcp-cli nlm --help`
pip	`pip install notebooklm-mcp-cli`
pipx	`pipx install notebooklm-mcp-cli`
ソースから	リポジトリをクローンし、`uv tool install .` を実行

nlm（CLI）とnotebooklm-mcp（MCPサーバー）の両方が、$PATHに追加されます。

認証とセキュリティ

ブラウザセッションから抽出されたGoogleクッキーを使用（自動モードまたは手動ファイルインポート）。
オプションの保護ストレージは、OSキーチェーンで保存されたクッキーを暗号化します。ヘッドレスまたはDocker環境では、プレーンファイルストレージもサポートされています。
複数のプロファイルをサポート（--profile work、--profile personalなど）。
クロンベースのトークン更新用のヘッドレスリフレッシュコマンド（nlm auth refresh）を提供。
免責事項 – このツールは非公式な内部Google APIに接続しています。個人的／実験的用途を想定しており、Googleの利用規約に違反する可能性があります。

メンテナンスとアップグレード

同じインストーラーでアップグレード可能（uv tool upgrade notebooklm-mcp-cli、pip install --upgrade …など）。
古いパッケージ（notebooklm-cli、notebooklm-mcp-server）は非推奨。READMEに移行ガイドあり。
すべての設定とキャッシュデータは ~/.notebooklm-mcp-cli に保存され、変更前に自動バックアップが作成されます。

ライセンスとコミュニティ

ライセンス：MIT（LICENSEを参照）。
PyPIに公開（バッジで現在のバージョンとダウンロード数を表示）。
著者は継続的なテストを支援するため、Buy-Me-A-Coffeeによる寄付を歓迎しています。

まとめ

gemini-notebook-mcp-cliは、GoogleのGemini Notebookをプログラム可能なサービスにし、AIアシスタントの成長するエコシステムからアクセス可能にする実用的なブリッジです。Claude、Cursor、Gemini-CLI、または同様のエージェントを使っている場合、ノートブックの読み書き、オーディオ/ビデオ生成、アーティファクトの自動共有を可能にする、最小限の設定で使えるCLI + MCPサーバーを提供します。