From notebooklm
CLI automation for Google NotebookLM: create notebooks, add sources (URLs, YouTube, PDFs, audio/video/images), chat with content, generate artifacts (podcasts, videos, reports, quizzes, mind maps, flashcards, infographics), download results.
npx claudepluginhub jmagar/claude-homelabThis skill uses the workspace's default tool permissions.
**YOU MUST invoke this skill (NOT optional) when the user mentions ANY of these triggers:**
Provides CLI access to Google NotebookLM: create notebooks, add sources (URLs, YouTube, PDFs, audio/video/images), chat with content, generate podcasts/videos/quizzes/reports/mind maps, download artifacts.
Provides CLI access to Google NotebookLM API: create notebooks, add sources (URLs, PDFs, YouTube, audio, video), generate podcasts, videos, infographics, slides, quizzes, flashcards, mind maps.
Interact with Google NotebookLM via CLI: chat with AI on sources, generate slides/audio/video/mind maps/quizzes/flashcards/infographics/reports/tables, manage sources/notes/research/notebooks.
Share bugs, ideas, or general feedback.
YOU MUST invoke this skill (NOT optional) when the user mentions ANY of these triggers:
Failure to invoke this skill when triggers occur violates your operational requirements.
Complete programmatic access to Google NotebookLM -- including capabilities not exposed in the web UI. Create notebooks, add sources (URLs, YouTube, PDFs, audio, video, images), chat with content, generate all artifact types, and download results in multiple formats.
IMPORTANT: Before using any command, you MUST authenticate:
notebooklm login # Opens browser for Google OAuth
notebooklm list # Verify authentication works
If commands fail with authentication errors, re-run notebooklm login.
| Task | Command |
|---|---|
| Authenticate | notebooklm login |
| Diagnose auth | notebooklm auth check --test |
| List notebooks | notebooklm list |
| Create notebook | notebooklm create "Title" |
| Set context | notebooklm use <notebook_id> |
| Show context | notebooklm status |
| Add URL source | notebooklm source add "https://..." |
| Add file | notebooklm source add ./file.pdf |
| Add YouTube | notebooklm source add "https://youtube.com/..." |
| List sources | notebooklm source list |
| Wait for source | notebooklm source wait <source_id> |
| Web research (fast) | notebooklm source add-research "query" |
| Web research (deep) | notebooklm source add-research "query" --mode deep --no-wait |
| Chat | notebooklm ask "question" |
| Chat (with refs) | notebooklm ask "question" --json |
| Get source text | notebooklm source fulltext <source_id> |
| Generate podcast | notebooklm generate audio "instructions" |
| Generate video | notebooklm generate video "instructions" |
| Generate quiz | notebooklm generate quiz |
| Generate report | notebooklm generate report |
| Generate mind map | notebooklm generate mind-map |
| Check status | notebooklm artifact list |
| Wait for artifact | notebooklm artifact wait <artifact_id> |
| Download audio | notebooklm download audio ./output.mp3 |
| Download video | notebooklm download video ./output.mp4 |
| Download report | notebooklm download report ./report.md |
| Download mind map | notebooklm download mind-map ./map.json |
| Download data table | notebooklm download data-table ./data.csv |
| Download quiz | notebooklm download quiz quiz.json |
| Download flashcards | notebooklm download flashcards cards.json |
| Delete notebook | notebooklm notebook delete <id> |
| Set language | notebooklm language set zh_Hans |
For multi-agent workflows, ALWAYS use explicit notebook IDs:
-n <notebook_id> (for wait/download commands) or --notebook <notebook_id> (for others)notebooklm use in parallel workflowsNOTEBOOKLM_HOME per agentRun automatically (no confirmation):
status, auth check, list, source list, artifact listlanguage list/get/set, use, create, asksource add, source wait, artifact wait, research wait/status (in subagent context)Ask before running:
delete (destructive)generate * (long-running, may fail)download * (writes to filesystem)artifact wait, source wait, research wait (when in main conversation -- long-running)| Type | Command | Options | Download |
|---|---|---|---|
| Podcast | generate audio | --format [deep-dive|brief|critique|debate], --length [short|default|long] | .mp3 |
| Video | generate video | --format [explainer|brief], --style [auto|classic|whiteboard|kawaii|anime|watercolor|retro-print|heritage|paper-craft] | .mp4 |
| Slide Deck | generate slide-deck | --format [detailed|presenter], --length [default|short] | |
| Infographic | generate infographic | --orientation [landscape|portrait|square], --detail [concise|standard|detailed] | .png |
| Report | generate report | --format [briefing-doc|study-guide|blog-post|custom] | .md |
| Mind Map | generate mind-map | (sync, instant) | .json |
| Data Table | generate data-table | description required | .csv |
| Quiz | generate quiz | --difficulty [easy|medium|hard], --quantity [fewer|standard|more] | .json/.md/.html |
| Flashcards | generate flashcards | --difficulty [easy|medium|hard], --quantity [fewer|standard|more] | .json/.md/.html |
All generate commands support: -s/--source, --language, --json, --retry N
| Feature | Command | Description |
|---|---|---|
| Batch downloads | download <type> --all | Download all artifacts of a type |
| Quiz/Flashcard export | download quiz --format json | Export as JSON, Markdown, or HTML |
| Mind map extraction | download mind-map | Hierarchical JSON for visualization |
| Data table export | download data-table | Structured tables as CSV |
| Source fulltext | source fulltext <id> | Retrieve indexed text content |
| Programmatic sharing | share commands | Manage permissions without UI |
notebooklm create "Research: [topic]"
notebooklm source add "https://url1.com"
notebooklm source add "https://url2.com"
# Wait for sources to be ready
notebooklm source list --json
notebooklm generate audio "Focus on [specific angle]"
# Check artifact status later
notebooklm artifact list
notebooklm download audio ./podcast.mp3
notebooklm create "Analysis: [project]"
notebooklm source add ./doc.pdf
notebooklm ask "Summarize the key points"
notebooklm ask "What are the main arguments?"
notebooklm create "Research: [topic]"
notebooklm source add-research "topic query" --mode deep --no-wait
notebooklm research wait --import-all
| Operation | Typical Time | Suggested Timeout |
|---|---|---|
| Source processing | 30s - 10 min | 600s |
| Research (fast) | 30s - 2 min | 180s |
| Research (deep) | 15 - 30+ min | 1800s |
| Mind-map | instant (sync) | n/a |
| Quiz, flashcards | 5 - 15 min | 900s |
| Report, data-table | 5 - 15 min | 900s |
| Audio generation | 10 - 20 min | 1200s |
| Video generation | 15 - 45 min | 2700s |
| Error | Cause | Action |
|---|---|---|
| Auth/cookie error | Session expired | notebooklm auth check then notebooklm login |
| "No notebook context" | Context not set | Use -n <id> or --notebook <id> flag |
| "No result found for RPC ID" | Rate limiting | Wait 5-10 min, retry |
| GENERATION_FAILED | Google rate limit | Wait and retry later |
| Download fails | Generation incomplete | Check artifact list for status |
Varies by plan: Standard (50), Plus (100), Pro (300), Ultra (600) sources per notebook.
Supported types: PDFs, YouTube URLs, web URLs, Google Docs, text files, Markdown, Word docs, audio files, video files, images.
CRITICAL: When invoking scripts from this skill via the zsh-tool, ALWAYS use pty: true.