notebooklm

NotebookLM Integration

Programmatic access to Google NotebookLM from Cursor. Supports per-project notebooks, automatic source syncing, and all artifact types.

---

Setup (run once, on first use)

Check if the CLI is already installed:

notebooklm --version 2>/dev/null || ~/.notebooklm-venv/bin/notebooklm --version 2>/dev/null

If not found, run the installer from the repo root:

chmod +x install.sh && ./install.sh

Or manually:

# Recommended: use uv (fast, no ensurepip issues)
uv venv ~/.notebooklm-venv --python python3.12
uv pip install "notebooklm-py[browser]" --python ~/.notebooklm-venv/bin/python
~/.notebooklm-venv/bin/playwright install chromium
mkdir -p ~/bin
ln -sf ~/.notebooklm-venv/bin/notebooklm ~/bin/notebooklm
export PATH="$HOME/bin:$PATH"

Authentication

Run this script to authenticate with Google. It opens a real browser window — sign in and navigate to notebooklm.google.com, then run the signal command:

cat > /tmp/nlm_login.py << 'PYEOF'
import json, time
from pathlib import Path
from playwright.sync_api import sync_playwright

STORAGE_PATH = Path.home() / ".notebooklm" / "storage_state.json"
PROFILE_PATH = Path.home() / ".notebooklm" / "browser_profile"
SIGNAL_FILE  = Path("/tmp/nlm_save_signal")

SIGNAL_FILE.unlink(missing_ok=True)
STORAGE_PATH.parent.mkdir(parents=True, exist_ok=True)

with sync_playwright() as p:
    browser = p.chromium.launch_persistent_context(
        user_data_dir=str(PROFILE_PATH),
        headless=False,
        args=["--disable-blink-features=AutomationControlled"],
    )
    page = browser.pages[0] if browser.pages else browser.new_page()
    page.goto("https://notebooklm.google.com/")
    print("Sign in, then run: touch /tmp/nlm_save_signal")
    while not SIGNAL_FILE.exists():
        time.sleep(1)
    storage = browser.storage_state()
    STORAGE_PATH.write_text(json.dumps(storage))
    print(f"Saved {len(storage.get('cookies', []))} cookies to {STORAGE_PATH}")
    browser.close()
SIGNAL_FILE.unlink(missing_ok=True)
PYEOF

source ~/.notebooklm-venv/bin/activate && python3 /tmp/nlm_login.py &