NotebookLM Skill
Query NotebookLM notebooks and manage notebooks/sources via Playwright browser automation.
All commands run from the skill directory. All scripts output JSON to stdout and exit 1 on error. Use --help on any script for full flag reference.
Workflow
- Authenticate:
python scripts/auth_manager.py setup --profile <name> - Register notebook:
python scripts/notebook_manager.py add --url <url> --name <name> --description <desc> --topics <topics> - Ask questions:
python scripts/ask_question.py --question "..." --notebook-id <id> - Manage sources:
python scripts/remote_manager.py add-source|sync-sources ...
Key Behaviors
- Runs headless by default; use
--show-browserfor debugging only. - Persistent Chrome profiles stored at
~/.config/claude/notebooklm-skill/(override withNOTEBOOKLM_DATA_DIR). - Hash-based dedupe: file uploads skip unchanged sources automatically.
--dry-runavailable on all destructive/bulk operations (create, add-source, delete-source, sync-sources).--retries Nretries transient browser failures with screenshot/HTML artifact capture.- Batch mode (
--questions "q1||q2||q3") and multi-notebook comparison (--compare-notebook-ids) supported. - Exports to JSON or Markdown via
--export-format markdown --save-notes. - Answers include a follow-up reminder prompting Claude to ask clarifying questions before replying.
Quick Reference
# Auth
python scripts/auth_manager.py setup --profile work
python scripts/auth_manager.py status --profile work
# Library
python scripts/notebook_manager.py add --url "..." --name "..." --description "..." --topics "..."
python scripts/notebook_manager.py list
# Ask
python scripts/ask_question.py --question "..." --notebook-id <id>
python scripts/ask_question.py --questions "q1||q2" --notebook-id <id>
# Sources
python scripts/remote_manager.py add-source --notebook-id <id> --dir ./docs --recursive
python scripts/remote_manager.py sync-sources --notebook-id <id> --dir ./docs --recursive --delete-missing --dry-run
For full command reference with all flags and examples, see references/commands.md.