/notebooklm

name: notebooklm
description: 'Full NotebookLM API via notebooklm-py CLI: create notebooks, add sources, generate podcasts, videos, infographics, slides, quizzes, flashcards, mind maps. Triggers on: "notebooklm", "create a podcast", "audio overview", "generate flashcards", "generate infographic", "/notebooklm".'
metadata:
  version: 1.1.1
  category: research
  tags: [notebooklm, podcast, flashcards, source-analysis]
  difficulty: intermediate

NotebookLM Automation

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.

Prerequisites

Installation

uv tool install notebooklm-py

Authentication (one-time)

notebooklm login          # Opens browser for Google OAuth
notebooklm list           # Verify authentication works

If commands fail with auth errors, re-run `notebooklm login`.

Verify Setup

notebooklm --version
notebooklm status         # Shows "Authenticated as: email@..."
notebooklm list --json    # Should return valid JSON

CI/CD and Parallel Agents

| Variable | Purpose | | ---------------------- | -------------------------------------------------- | | `NOTEBOOKLM_HOME` | Custom config directory (default: `~/.notebooklm`) | | `NOTEBOOKLM_AUTH_JSON` | Inline auth JSON — no file writes needed |

**Parallel agents:** The CLI stores notebook context in `~/.notebooklm/context.json`. Multiple concurrent agents using `notebooklm use` overwrite each other's context. Use explicit `-n <notebook_id>` or `--notebook <notebook_id>` flags instead, or set unique `NOTEBOOKLM_HOME` per agent.

Quick Reference

| 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` | | Check research status | `notebooklm research status` | | Wait for research | `notebooklm research wait --import-all` | | Chat | `notebooklm ask "question"` | | Chat (new conversation) | `notebooklm ask "question" --new` | | Chat (specific sources) | `notebooklm ask "question" -s src_id1 -s src_id2` | | Chat (with references) | `notebooklm ask "question" --json` | | Get source fulltext | `notebooklm source fulltext <source_id>` | | Get source guide | `notebooklm source guide <source_id>` | | Generate podcast | `notebooklm generate audio "instructions"` | | Generate video | `notebooklm generate video "instructions"` | | Generate quiz | `notebooklm generate quiz` | | Generate infographic | `notebooklm generate infographic` | | Generate slide deck | `notebooklm generate slide-deck` | | Generate report | `notebooklm generate report` | | Generate mind map | `notebooklm generate mind-map` | | Generate data table | `notebooklm generate data-table "description"` | | Generate flashcards | `notebooklm generate flashcards` | | Check artifact status | `notebooklm artifact list` | | Wait for completion | `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 quiz (markdown) | `notebooklm download quiz --format markdown quiz.md` | | Download flashcards | `notebooklm download flashcards cards.json` | | Download infographic | `notebooklm download infographic ./infographic.png` | | Download slide deck | `notebooklm download slide-deck ./slides.pdf`