NotebookLM MCP Server

## Troubleshooting ### Fresh start / Deep cleanup If you're experiencing persistent issues, corrupted data, or want to start completely fresh: **⚠️ CRITICAL: Close ALL Chrome/Chromium instances before cleanup!** Open browsers can prevent cleanup and cause issues. **Recommended workflow:** 1. Close all Chrome/Chromium windows and instances 2. Ask: "Run NotebookLM cleanup and preserve my library" 3. Review the preview - you'll see exactly what will be deleted 4. Confirm deletion 5. Re-authenticate: "Open NotebookLM auth setup" **What gets cleaned:** - Browser data, cache, Chrome profiles - Temporary files and logs - Old installation data - **Preserved:** Your notebook library (when using preserve option) **Useful for:** - Authentication problems - Browser session conflicts - Corrupted browser profiles - Clean reinstalls - Switching between accounts ### Browser closed / `newPage` errors - Symptom: `browserContext.newPage: Target page/context/browser has been closed`. - Fix: The server auto‑recovers (recreates context and page). Re‑run the tool. ### Profile lock / `ProcessSingleton` errors - Cause: Another Chrome is using the base profile. - Fix: `NOTEBOOK_PROFILE_STRATEGY=auto` (default) falls back to isolated per‑instance profiles; or set `isolated`. ### Authentication issues **Quick fix:** Ask the agent to repair authentication; it will run `get_health` → `setup_auth` → `get_health`. **For persistent auth failures:** 1. Close ALL Chrome/Chromium instances 2. Ask: "Run NotebookLM cleanup with library preservation" 3. After cleanup completes, ask: "Open NotebookLM auth setup" 4. This creates a completely fresh browser session while keeping your notebooks **Auto-login (optional):** - Set `AUTO_LOGIN_ENABLED=true` with `LOGIN_EMAIL`, `LOGIN_PASSWORD` environment variables - For automation workflows only ### Typing speed too slow/fast - Adjust `TYPING_WPM_MIN`/`MAX`; or disable stealth typing by setting `STEALTH_ENABLED=false`. ### Rate limit reached - Symptom: "NotebookLM rate limit reached (50 queries/day for free accounts)". - Fix: Use `re_auth` tool to switch to a different Google account, or wait until tomorrow. - Upgrade: Google AI Pro/Ultra gives 5x higher limits. ### No notebooks found - Ask to add the NotebookLM link you need. - Ask to list the stored notebooks, then choose the one to activate.