claude-config/memory/notebooklm-cli-setup.md

name, description, metadata

name	description	metadata
notebooklm-cli-setup	NotebookLM CLI (teng-lin/notebooklm-py) installed on the Mac — install gotchas, auth, and the launchd keepalive	node_type type originSessionId memory project f102e698-22a7-4706-8063-b599e2bd5fb1

Google NotebookLM wired into Claude Code on the Mac Mini via teng-lin/notebooklm-py (unofficial; no public NotebookLM API exists — Enterprise API is the only official path). Installed 2026-07-16.

• Install: uv tool install --python 3.12 --force "notebooklm-py[browser]" → binary at ~/.local/bin/notebooklm (v0.7.3). Gotcha: plain uv tool install silently backtracks to the ancient 0.1.1 release (which tracebacks on import) because stock macOS Python is 3.9 and 0.7.3 needs ≥3.10. Always pin --python 3.12. uv itself came from Homebrew.
• Skill: notebooklm skill install → ~/.claude/skills/notebooklm/SKILL.md (+ ~/.agents/skills/ for Codex). It's a skill, NOT an MCP server — won't show in claude mcp list, and the project_plugin_sync repo won't carry it to other machines. Each machine needs its own install + Google auth (creds are per-machine).
• Auth: notebooklm login --browser chrome (bundled Chromium crashes on macOS 15+/27; use system Chrome). Browser sign-in, auto-saves ~/.notebooklm/profiles/default/storage_state.json. There is no "master-token" auth despite the repo blurb implying one.
• Durability ("all the time"): launchd keepalive at ~/Library/LaunchAgents/uk.timevans.notebooklm-refresh.plist runs notebooklm auth refresh --quiet every 1200s, logs to ~/.notebooklm/refresh.log (empty log = healthy; --quiet only writes on error). Loaded via launchctl load. Still an unofficial cookie session — a Google-side change or revocation needs a fresh notebooklm login; the log is where failure surfaces.
• Verify: notebooklm auth check --test (live token fetch) and notebooklm list. Free tier ~50 queries/day.