@roomi-fields/notebooklm-mcp 1.5.7 → 1.5.9

package/deployment/docs/08-WSL-USAGE.md

@@ -37,7 +37,7 @@ Due to browser requirements (Playwright needs Chrome), the HTTP server must run
 Open a **Windows terminal** (PowerShell or CMD, not WSL):
 
 ```powershell
-cd D:\Claude\notebooklm-mcp-http
+cd D:\path\to\notebooklm-mcp
 npm run start:http
 ```
 
@@ -129,7 +129,7 @@ mcp__notebooklm__ask_question(question="...", notebook_id="my-notebook")
 ```powershell
 # From Windows (not WSL):
 taskkill /F /IM node.exe
-cd D:\Claude\notebooklm-mcp-http
+cd D:\path\to\notebooklm-mcp
 npm run start:http
 ```
 
@@ -165,7 +165,7 @@ Kill all node processes and restart:
 
 ```powershell
 taskkill /F /IM node.exe
-cd D:\Claude\notebooklm-mcp-http
+cd D:\path\to\notebooklm-mcp
 npm run start:http
 ```
 
@@ -265,7 +265,7 @@ The project includes PowerShell scripts for managing the server:
 ### Run in Background (Hidden Window)
 
 ```powershell
-Start-Process powershell -ArgumentList "-ExecutionPolicy Bypass -File D:\Claude\notebooklm-mcp-http\scripts\start-server.ps1" -WindowStyle Hidden
+Start-Process powershell -ArgumentList "-ExecutionPolicy Bypass -File D:\path\to\notebooklm-mcp\scripts\start-server.ps1" -WindowStyle Hidden
 ```
 
 ### Windows Task Scheduler (Auto-start on Login)
@@ -275,7 +275,7 @@ Start-Process powershell -ArgumentList "-ExecutionPolicy Bypass -File D:\Claude\
 3. Trigger: "When I log on"
 4. Action: Start a program
    - Program: `powershell.exe`
-   - Arguments: `-ExecutionPolicy Bypass -WindowStyle Hidden -File "D:\Claude\notebooklm-mcp-http\scripts\start-server.ps1"`
+   - Arguments: `-ExecutionPolicy Bypass -WindowStyle Hidden -File "D:\path\to\notebooklm-mcp\scripts\start-server.ps1"`
 5. Check "Open Properties dialog" and set "Run whether user is logged on or not"
 
 ## Authentication Procedure (TOTP/2FA)
@@ -292,7 +292,7 @@ taskkill /F /IM node.exe
 ### Step 2: Run accounts test with visible browser
 
 ```powershell
-cd D:\Claude\notebooklm-mcp-http
+cd D:\path\to\notebooklm-mcp
 npm run accounts test account-XXXXXXXXXXXXX -- --show
 ```
 
@@ -321,7 +321,7 @@ cp /mnt/c/Users/USERNAME/AppData/Local/notebooklm-mcp/Data/accounts/account-*/br
 ### Step 4: Start HTTP server
 
 ```powershell
-cd D:\Claude\notebooklm-mcp-http
+cd D:\path\to\notebooklm-mcp
 npm run start:http
 ```
 

package/deployment/docs/09-MULTI-INTERFACE.md

@@ -47,7 +47,7 @@ The **Stdio-HTTP Proxy** enables Claude Desktop to communicate with the HTTP ser
 **From PowerShell (recommended):**
 
 ```powershell
-cd D:\Claude\notebooklm-mcp-http
+cd D:\path\to\notebooklm-mcp
 
 # Build if needed
 npm run build
@@ -63,7 +63,7 @@ Start-Process -NoNewWindow node -ArgumentList "dist/http-wrapper.js"
 
 ```bash
 # Helper script handles everything correctly
-HELPER=/mnt/d/Claude/notebooklm-mcp-http/scripts/mcp-wsl-helper.sh
+HELPER=/mnt/d/path/to/notebooklm-mcp/scripts/mcp-wsl-helper.sh
 
 $HELPER start      # Start server (Windows process)
 $HELPER health     # Check health
@@ -76,7 +76,7 @@ $HELPER stop       # Stop server
 
 ```bash
 # This launches node.exe on Windows, NOT node in WSL
-powershell.exe -Command "Start-Process -NoNewWindow -FilePath 'node' -ArgumentList 'D:/Claude/notebooklm-mcp-http/dist/http-wrapper.js' -WorkingDirectory 'D:/Claude/notebooklm-mcp-http'"
+powershell.exe -Command "Start-Process -NoNewWindow -FilePath 'node' -ArgumentList 'D:/path/to/notebooklm-mcp/dist/http-wrapper.js' -WorkingDirectory 'D:/path/to/notebooklm-mcp'"
 ```
 
 ### Step 2: Configure Claude Desktop
@@ -92,7 +92,7 @@ Edit your Claude Desktop config file:
   "mcpServers": {
     "notebooklm": {
       "command": "node",
-      "args": ["D:/Claude/notebooklm-mcp-http/dist/stdio-http-proxy.js"],
+      "args": ["D:/path/to/notebooklm-mcp/dist/stdio-http-proxy.js"],
       "env": {
         "MCP_HTTP_URL": "http://localhost:3000"
       }
@@ -231,7 +231,7 @@ The HTTP server MUST run as a Windows process to access Chrome. Fix:
 
 ```bash
 # Use the helper script (recommended)
-HELPER=/mnt/d/Claude/notebooklm-mcp-http/scripts/mcp-wsl-helper.sh
+HELPER=/mnt/d/path/to/notebooklm-mcp/scripts/mcp-wsl-helper.sh
 
 # 1. Stop any running server
 $HELPER stop
@@ -250,7 +250,7 @@ $HELPER health
 pkill -f http-wrapper
 
 # 2. Start as Windows process
-powershell.exe -Command "Start-Process -NoNewWindow -FilePath 'node' -ArgumentList 'D:/Claude/notebooklm-mcp-http/dist/http-wrapper.js' -WorkingDirectory 'D:/Claude/notebooklm-mcp-http'"
+powershell.exe -Command "Start-Process -NoNewWindow -FilePath 'node' -ArgumentList 'D:/path/to/notebooklm-mcp/dist/http-wrapper.js' -WorkingDirectory 'D:/path/to/notebooklm-mcp'"
 
 # 3. Verify (via PowerShell, not curl from WSL)
 powershell.exe -Command "Invoke-RestMethod -Uri 'http://localhost:3000/health'"

package/deployment/docs/10-CONTENT-MANAGEMENT.md

@@ -21,22 +21,17 @@ The Content Management module enables you to:
 
 **REAL NotebookLM Features (fully integrated):**
 
-- Audio Overview generation - Uses NotebookLM's actual podcast feature
-- Audio download - Downloads the real generated audio file
-- Source management - Add files, URLs, text, YouTube videos
-- Q&A with citations - Uses NotebookLM's actual chat
+- Audio Overview generation — NotebookLM's actual podcast feature
+- Video generation — brief + explainer with 6 visual styles (classroom, documentary, animated, corporate, cinematic, minimalist)
+- Infographic generation — horizontal and vertical layouts
+- Report / Presentation / Data Table — text-based content returned in the API response
+- Download artifacts — WAV audio, MP4 video, PNG infographics
+- Source management — add files, URLs, text, YouTube videos, Google Drive
+- Q&A with citations — DOM-extracted source names and excerpts
 
-**NOT Supported (removed in v1.4.2):**
+**Prompt-based content (use `ask_question` directly):**
 
-The following were removed because they were NOT real NotebookLM integrations. They were just sending prompts to the chat, which you can do yourself with `ask_question`:
-
-- ~~Briefing Doc~~ - Just asked chat to generate a summary
-- ~~Study Guide~~ - Just asked chat to create study materials
-- ~~FAQ~~ - Just asked chat to generate FAQs
-- ~~Timeline~~ - Just asked chat to create a timeline
-- ~~Table of Contents~~ - Just asked chat to create a TOC
-
-If you need these, simply use `ask_question` with your own prompt like "Create a study guide" or "Generate an FAQ".
+For content types that NotebookLM doesn't expose as first-class studio outputs — briefing docs, study guides, FAQ, timelines, tables of contents — call `ask_question` with a custom prompt (e.g. "Create a study guide from these sources"). These are regular chat responses, not separate NotebookLM integrations.
 
 ---
 
@@ -410,11 +405,12 @@ Audio generation can take 5-10 minutes. The API will wait up to 10 minutes for c
 
 ## Version History
 
-| Version | Changes                                     |
-| ------- | ------------------------------------------- |
-| 1.4.2   | Removed fake content generation (FAQ, etc.) |
-| 1.4.0   | Added content management module             |
-| 1.3.7   | Source citation extraction                  |
+| Version | Changes                                                                             |
+| ------- | ----------------------------------------------------------------------------------- |
+| 1.5.x   | 2026 UI selectors, re-added video/infographic/presentation/report/data_table        |
+| 1.4.2   | Removed fake content generation (FAQ, etc.) — re-added later as real studio outputs |
+| 1.4.0   | Added content management module                                                     |
+| 1.3.7   | Source citation extraction                                                          |
 
 ---
 

package/deployment/docs/11-MULTI-ACCOUNT.md

@@ -259,7 +259,7 @@ Each account may have a different Google Account language setting. The server us
 Use the provided script to switch an account's language:
 
 ```bash
-./scripts/switch-account-language.sh --account=mathieu --lang=fr --show
+./scripts/switch-account-language.sh --account=account-b --lang=fr --show
 ```
 
 **What it does:**

package/deployment/docs/README.md

@@ -144,59 +144,13 @@
 
 ---
 
-## Changelog
+## Release History
 
-### v1.4.2 (2025-12-29)
+Every release from 1.0.0 to the current version is documented with full "Added / Changed / Fixed / Security" breakdowns.
 
-**Removed fake content generation:**
+👉 **[See the full release history](/changelog)** — 13 versions, 6 years of changes.
 
-- Removed `generate_content` endpoint for FAQ, Study Guide, Briefing Doc, Timeline, TOC
-- These were NOT real NotebookLM features - just chat prompts
-- Only REAL content generation: Audio Overview (podcast)
-- Updated all documentation for honesty
-
-### v1.4.0 (2025-12-24)
-
-**Content Management:**
-
-- Audio Overview generation (podcast) - REAL NotebookLM feature
-- Audio download
-- Source management (files, URLs, text, YouTube)
-
-### v1.3.1 (2025-01-24)
-
-**New features:**
-
-- MCP Auto-Discovery Tool: `auto_discover_notebook` for Claude Desktop/Cursor
-- Parity with HTTP API: MCP clients now have auto-discovery capability
-- Zero-friction notebook addition: just URL, metadata auto-generated
-
-**Critical Fixes:**
-
-- Claude Desktop compatibility: Disabled `CompleteRequestSchema` handler
-- Fixed "Server does not support completions" error on connection
-
-### v1.1.2 (2025-11-22)
-
-**New features:**
-
-- ✅ Multi-notebook library system
-- ✅ Live validation of notebooks when adding
-- ✅ Protection against duplicate names
-- ✅ DELETE and PUT endpoints for notebooks
-- ✅ Detailed and contextualized error messages
-
-**Fixes:**
-
-- ✅ Fixed Cookies path (Default/Network/Cookies)
-- ✅ Cookies threshold lowered to 10KB
-- ✅ Better temporary session management
-
-**Documentation:**
-
-- ✅ New guide [06-NOTEBOOK-LIBRARY.md](./06-NOTEBOOK-LIBRARY.md)
-- ✅ "Notebook Configuration" section in [01-INSTALL.md](./01-INSTALL.md)
-- ✅ Enhanced API in [03-API.md](./03-API.md)
+Latest: **v1.5.8 (2026-04-19)** — 2026 NotebookLM UI selectors, doctor scripts, PII scrub, `npm audit fix`.
 
 ---
 

package/deployment/scripts/install.ps1

@@ -1,114 +1,114 @@
-# Automatic installation script - NotebookLM MCP HTTP Server
-# Version: 1.3.0
-# Description: Installs all dependencies and compiles the project
-
-Write-Host "╔══════════════════════════════════════════════════════════╗" -ForegroundColor Cyan
-Write-Host "║  NotebookLM MCP - Automatic Installation                 ║" -ForegroundColor Cyan
-Write-Host "╚══════════════════════════════════════════════════════════╝" -ForegroundColor Cyan
-Write-Host ""
-
-# Check Node.js
-Write-Host "🔍 Checking Node.js..." -ForegroundColor Yellow
-try {
-    $nodeVersion = node --version
-    $npmVersion = npm --version
-    Write-Host "✅ Node.js $nodeVersion found" -ForegroundColor Green
-    Write-Host "✅ npm $npmVersion found" -ForegroundColor Green
-} catch {
-    Write-Host "❌ Node.js is not installed!" -ForegroundColor Red
-    Write-Host ""
-    Write-Host "📥 Download Node.js from: https://nodejs.org/" -ForegroundColor Yellow
-    Write-Host "   Install the LTS version and run this script again." -ForegroundColor Yellow
-    exit 1
-}
-
-Write-Host ""
-
-# Check that we're in the right directory
-Write-Host "🔍 Checking directory..." -ForegroundColor Yellow
-if (-not (Test-Path "package.json")) {
-    Write-Host "❌ package.json file not found!" -ForegroundColor Red
-    Write-Host "   Make sure you are in the project root directory." -ForegroundColor Yellow
-    exit 1
-}
-
-$projectName = (Get-Content "package.json" -Raw | ConvertFrom-Json).name
-Write-Host "✅ Project detected: $projectName" -ForegroundColor Green
-Write-Host ""
-
-# Install dependencies
-Write-Host "📦 Installing npm dependencies..." -ForegroundColor Yellow
-Write-Host "   (This may take 2-5 minutes)" -ForegroundColor Gray
-Write-Host ""
-
-npm install
-
-if ($LASTEXITCODE -ne 0) {
-    Write-Host ""
-    Write-Host "❌ Error during dependency installation" -ForegroundColor Red
-    Write-Host "   Check your Internet connection and try again." -ForegroundColor Yellow
-    exit 1
-}
-
-Write-Host ""
-Write-Host "✅ Dependencies installed successfully!" -ForegroundColor Green
-Write-Host ""
-
-# TypeScript compilation
-Write-Host "🔨 Compiling project..." -ForegroundColor Yellow
-npm run build
-
-if ($LASTEXITCODE -ne 0) {
-    Write-Host ""
-    Write-Host "❌ Error during compilation" -ForegroundColor Red
-    exit 1
-}
-
-Write-Host ""
-Write-Host "✅ Compilation successful!" -ForegroundColor Green
-Write-Host ""
-
-# Final checks
-Write-Host "🔍 Final checks..." -ForegroundColor Yellow
-
-$checks = @(
-    @{File = "dist\http-wrapper.js"; Description = "HTTP Server"},
-    @{File = "dist\index.js"; Description = "MCP Server"},
-    @{File = "node_modules\express"; Description = "Express.js"}
-)
-
-$allOk = $true
-foreach ($check in $checks) {
-    if (Test-Path $check.File) {
-        Write-Host "  ✅ $($check.Description)" -ForegroundColor Green
-    } else {
-        Write-Host "  ❌ $($check.Description) - $($check.File) not found" -ForegroundColor Red
-        $allOk = $false
-    }
-}
-
-Write-Host ""
-
-if ($allOk) {
-    Write-Host "╔══════════════════════════════════════════════════════════╗" -ForegroundColor Green
-    Write-Host "║  ✅ INSTALLATION COMPLETED SUCCESSFULLY!                 ║" -ForegroundColor Green
-    Write-Host "╚══════════════════════════════════════════════════════════╝" -ForegroundColor Green
-    Write-Host ""
-    Write-Host "📋 Next steps:" -ForegroundColor Cyan
-    Write-Host ""
-    Write-Host "1️⃣  Configure Google authentication (one time only):" -ForegroundColor White
-    Write-Host "   .\deployment\scripts\setup-auth.ps1" -ForegroundColor Gray
-    Write-Host ""
-    Write-Host "2️⃣  Start the server:" -ForegroundColor White
-    Write-Host "   npm run start:http" -ForegroundColor Gray
-    Write-Host ""
-    Write-Host "3️⃣  Test the server:" -ForegroundColor White
-    Write-Host "   curl http://localhost:3000/health" -ForegroundColor Gray
-    Write-Host ""
-    Write-Host "📖 Complete documentation: .\deployment\docs\" -ForegroundColor Cyan
-    Write-Host ""
-} else {
-    Write-Host "❌ Installation encountered problems" -ForegroundColor Red
-    Write-Host "   See: .\deployment\docs\05-TROUBLESHOOTING.md" -ForegroundColor Yellow
-    exit 1
-}
+# Automatic installation script - NotebookLM MCP HTTP Server
+# Version: 1.3.0
+# Description: Installs all dependencies and compiles the project
+
+Write-Host "╔══════════════════════════════════════════════════════════╗" -ForegroundColor Cyan
+Write-Host "║  NotebookLM MCP - Automatic Installation                 ║" -ForegroundColor Cyan
+Write-Host "╚══════════════════════════════════════════════════════════╝" -ForegroundColor Cyan
+Write-Host ""
+
+# Check Node.js
+Write-Host "🔍 Checking Node.js..." -ForegroundColor Yellow
+try {
+    $nodeVersion = node --version
+    $npmVersion = npm --version
+    Write-Host "✅ Node.js $nodeVersion found" -ForegroundColor Green
+    Write-Host "✅ npm $npmVersion found" -ForegroundColor Green
+} catch {
+    Write-Host "❌ Node.js is not installed!" -ForegroundColor Red
+    Write-Host ""
+    Write-Host "📥 Download Node.js from: https://nodejs.org/" -ForegroundColor Yellow
+    Write-Host "   Install the LTS version and run this script again." -ForegroundColor Yellow
+    exit 1
+}
+
+Write-Host ""
+
+# Check that we're in the right directory
+Write-Host "🔍 Checking directory..." -ForegroundColor Yellow
+if (-not (Test-Path "package.json")) {
+    Write-Host "❌ package.json file not found!" -ForegroundColor Red
+    Write-Host "   Make sure you are in the project root directory." -ForegroundColor Yellow
+    exit 1
+}
+
+$projectName = (Get-Content "package.json" -Raw | ConvertFrom-Json).name
+Write-Host "✅ Project detected: $projectName" -ForegroundColor Green
+Write-Host ""
+
+# Install dependencies
+Write-Host "📦 Installing npm dependencies..." -ForegroundColor Yellow
+Write-Host "   (This may take 2-5 minutes)" -ForegroundColor Gray
+Write-Host ""
+
+npm install
+
+if ($LASTEXITCODE -ne 0) {
+    Write-Host ""
+    Write-Host "❌ Error during dependency installation" -ForegroundColor Red
+    Write-Host "   Check your Internet connection and try again." -ForegroundColor Yellow
+    exit 1
+}
+
+Write-Host ""
+Write-Host "✅ Dependencies installed successfully!" -ForegroundColor Green
+Write-Host ""
+
+# TypeScript compilation
+Write-Host "🔨 Compiling project..." -ForegroundColor Yellow
+npm run build
+
+if ($LASTEXITCODE -ne 0) {
+    Write-Host ""
+    Write-Host "❌ Error during compilation" -ForegroundColor Red
+    exit 1
+}
+
+Write-Host ""
+Write-Host "✅ Compilation successful!" -ForegroundColor Green
+Write-Host ""
+
+# Final checks
+Write-Host "🔍 Final checks..." -ForegroundColor Yellow
+
+$checks = @(
+    @{File = "dist\http-wrapper.js"; Description = "HTTP Server"},
+    @{File = "dist\index.js"; Description = "MCP Server"},
+    @{File = "node_modules\express"; Description = "Express.js"}
+)
+
+$allOk = $true
+foreach ($check in $checks) {
+    if (Test-Path $check.File) {
+        Write-Host "  ✅ $($check.Description)" -ForegroundColor Green
+    } else {
+        Write-Host "  ❌ $($check.Description) - $($check.File) not found" -ForegroundColor Red
+        $allOk = $false
+    }
+}
+
+Write-Host ""
+
+if ($allOk) {
+    Write-Host "╔══════════════════════════════════════════════════════════╗" -ForegroundColor Green
+    Write-Host "║  ✅ INSTALLATION COMPLETED SUCCESSFULLY!                 ║" -ForegroundColor Green
+    Write-Host "╚══════════════════════════════════════════════════════════╝" -ForegroundColor Green
+    Write-Host ""
+    Write-Host "📋 Next steps:" -ForegroundColor Cyan
+    Write-Host ""
+    Write-Host "1️⃣  Configure Google authentication (one time only):" -ForegroundColor White
+    Write-Host "   .\deployment\scripts\setup-auth.ps1" -ForegroundColor Gray
+    Write-Host ""
+    Write-Host "2️⃣  Start the server:" -ForegroundColor White
+    Write-Host "   npm run start:http" -ForegroundColor Gray
+    Write-Host ""
+    Write-Host "3️⃣  Test the server:" -ForegroundColor White
+    Write-Host "   curl http://localhost:3000/health" -ForegroundColor Gray
+    Write-Host ""
+    Write-Host "📖 Complete documentation: .\deployment\docs\" -ForegroundColor Cyan
+    Write-Host ""
+} else {
+    Write-Host "❌ Installation encountered problems" -ForegroundColor Red
+    Write-Host "   See: .\deployment\docs\05-TROUBLESHOOTING.md" -ForegroundColor Yellow
+    exit 1
+}