notebooklm

NotebookLM AI Plugin

Drive Google NotebookLM (https://notebook.google.com) from the terminal. Both notebook.google.com and notebooklm.google.com notebook URLs are accepted.

Supports:

• Chat with Notebook AI (source-grounded Q&A with citations)
• Slide Deck generation (PPTX/PDF)
• Audio Overview (M4A — deep dive, brief, critique, debate formats)
• Video Overview (MP4 — auto, classic, whiteboard, kawaii, anime, watercolor, retro_print, heritage, paper_craft styles)
• Mind Map (JSON tree)
• Flashcards / Quiz (interactive HTML)
• Infographic (PNG — landscape, portrait, square; 11 visual styles)
• Report (Markdown — briefing doc, study guide, blog post, custom prompt)
• Data Table (CSV)
• Source management (add URLs, YouTube, files, pasted text; list, delete)
• Fast/Deep web research with auto-import
• Notes management (create, update, delete, list)
• Notebook library management (add, list, search, activate) + listing your account's notebooks

All commands run from this skill directory:

cd <skill-dir>   # the folder containing SKILL.md
npx -y bun scripts/main.ts <command> [options]

Quick start

# 1. Authenticate (opens Chrome for Google login; cookies are cached)
npx -y bun scripts/main.ts login

# 2. Check the session and see your notebooks (ids + source counts)
npx -y bun scripts/main.ts notebooks remote

# 3. Save one as the default
npx -y bun scripts/main.ts notebooks add https://notebook.google.com/notebook/<id> --name "My Research"

# 4. Use it
npx -y bun scripts/main.ts chat --question "What are the key findings?"
npx -y bun scripts/main.ts generate slide_deck --output slides.pdf
npx -y bun scripts/main.ts generate audio --format deep_dive --length long
npx -y bun scripts/main.ts generate quiz --difficulty medium --quantity more --output quiz.html
npx -y bun scripts/main.ts generate data_table --instructions "Compare the frameworks" --output table.csv

Authentication

login launches Chrome (with a dedicated profile under the data dir) and waits for you to sign in at notebook.google.com, then captures the Google session cookies. Cookies expire after a few weeks; any command that hits a login redirect tells you to run login --force.

npx -y bun scripts/main.ts login            # reuse cached cookies if still valid
npx -y bun scripts/main.ts login --force    # always re-open Chrome
npx -y bun scripts/main.ts notebooks remote # fast auth check: lists notebooks from your account

Every RPC call fetches a fresh CSRF token (SNlM0e) and session id (FdrFJe) from the app page, so nothing else needs refreshing. If the origin changes again, set NOTEBOOKLM_BASE_URL (or edit scripts/constants.ts).

Commands

Notebook management

npx -y bun scripts/main.ts notebooks remote                 # notebooks on your Google account (live)
npx -y bun scripts/main.ts notebooks list                   # local library
npx -y bun scripts/main.ts notebooks add <url> [--name <name>] [--description <desc>] [--topics <t1,t2>]
npx -y bun scripts/main.ts notebooks remove <id>
npx -y bun scripts/main.ts notebooks activate <id>          # default for every other command
npx -y bun scripts/main.ts notebooks search <query>

Chat with Notebook AI

npx -y bun scripts/main.ts chat --question "What are the key findings?" --notebook <url|id>
npx -y bun scripts/main.ts chat --question "Tell me more about that" --conversation-id <id>
npx -y bun scripts/main.ts chat --question "Summarize the methodology" --json   # answer + citations

Chat uses all ready sources in the notebook. Citations reference source ids (see sources list).

Source management

npx -y bun scripts/main.ts sources list --notebook <url|id>          # id, title, type, status, url
npx -y bun scripts/main.ts sources add-url https://example.com/article
npx -y bun scripts/main.ts sources add-youtube https://youtube.com/watch?v=xxx
npx -y bun scripts/main.ts sources add-text --title "My Notes" --content "Important findings..."
npx -y bun scripts/main.ts sources add-file ./paper.pdf
npx -y bun scripts/main.ts sources delete <sourceId>

New sources show status: processing for a little while; generation and chat only use sources whose status is ready. Supported files: PDF, TXT, MD, DOCX, PPTX, CSV, EPUB, images (PNG, JPG, WEBP), audio/video.

Research

npx -y bun scripts/main.ts research fast --query "latest AI agent frameworks"   # ~1–3 min
npx -y bun scripts/main.ts research deep --query "state of LLM reasoning"       # ~5–10 min, produces a report
npx -y bun scripts/main.ts research fast --query "topic" --import                # import found sources
npx -y bun scripts/main.ts research status

Notes

npx -y bun scripts/main.ts notes list
npx -y bun scripts/main.ts notes create --title "Key Takeaways" --content "1. Finding one..."
npx -y bun scripts/main.ts notes update <noteId> --title "Updated" --content "New content"
npx -y bun scripts/main.ts notes delete <noteId>

Artifacts

npx -y bun scripts/main.ts artifacts list                 # everything in the Studio panel, with status
npx -y bun scripts/main.ts generate <type> [options]

Types: slide_deck, audio, video, mind_map, flashcards, quiz, infographic, report, data_table

Generation is asynchronous on Google's side: the command creates the artifact, polls the Studio list until it is completed and its download URL is available (audio/video can take 10–20 minutes), then downloads it. If auto-download fails, the URL is printed so it can be opened in a browser.

Options

Global options

Option	Description
--notebook <url|id>	Notebook URL or library id (defaults to the active notebook)
--output <path>	Output file path (auto-named under the data dir if omitted)
--instructions <text>	Custom instructions / focus for generation
--language <code>	Output language (default en)
--json	Machine-readable output

Per-type options

Type	Options
audio	--format deep_dive|brief|critique|debate, --length short|default|long
video	--style auto|classic|whiteboard|kawaii|anime|watercolor|retro_print|heritage|paper_craft, --format explainer|brief|cinematic|short
slide_deck	--format detailed|presenter|pdf|pptx, --length default|short (PPTX by default; --format pdf or an .pdf output path selects the PDF)
quiz, flashcards	--difficulty easy|medium|hard, --quantity fewer|standard|more
infographic	--orientation landscape|portrait|square, --detail concise|standard|detailed, --style auto|sketch_note|professional|bento_grid|editorial|instructional|bricks|clay|anime|kawaii|scientific
report	--format briefing|study_guide|blog_post|custom, --prompt "<full prompt>" (custom)
mind_map	--instructions only
data_table	--instructions (what to tabulate)

Output formats

Type	Output
slide_deck	PPTX (or PDF)
audio	M4A
video	MP4
mind_map	JSON tree { name, children: [...] }
flashcards, quiz	self-contained interactive HTML
infographic	PNG
report	Markdown
data_table	CSV (headers + rows)

Environment variables

Variable	Description
NOTEBOOKLM_BASE_URL	App origin override (default https://notebook.google.com)
NOTEBOOKLM_DATA_DIR	Data directory (cookies, library, Chrome profile, outputs)
NOTEBOOKLM_COOKIE_PATH	Cookie file path
NOTEBOOKLM_CHROME_PATH / NOTEBOOKLM_CHROME_PROFILE_DIR	Chrome executable / profile
NOTEBOOKLM_OUTPUT_DIR	Default output directory
NOTEBOOKLM_BL	Build label sent on chat requests (not validated by the server)

Rate limits (free tier)

Resource	Limit
Audio/video overviews	3 per day
Reports/flashcards/quizzes	10 per day
Daily chats	50
Notebooks	100, 50 sources each

Quota rejections surface as an RPCError of kind rate_limit.

Troubleshooting

Symptom	Meaning / fix
redirected (302) to …/login	Cookies expired → login --force
redirected … The app origin may have changed	Google moved the app again → set NOTEBOOKLM_BASE_URL
RPC xxxx not present in response … method ID may have changed	Google rotated an RPC id → update scripts/rpc-types.ts (compare with notebooklm-py)
INVALID_ARGUMENT / FAILED_PRECONDITION	Payload shape rejected — run npx -y bun test and diff scripts/*-manager.ts against the reference projects
did not return an artifact ID	Notebook has no ready sources, or the artifact type isn't enabled for the account

Tests

cd test
npx -y bun install                          # dev deps only (typescript, types)
npx -y bun x tsc --noEmit                   # type-check
npx -y bun test unit                        # offline: payload shapes + decoders against recorded responses
npx -y bun test live.test.ts                # live: auth + read endpoints (skips without a session)
NOTEBOOKLM_LIVE_WRITE=1 npx -y bun test live.test.ts             # + add/delete a text source and a note
NOTEBOOKLM_LIVE_GENERATE=quiz npx -y bun test live.test.ts       # + generate one artifact end-to-end

Skill-level evals (prompts + assertions for the skill-creator harness) live in test/evals.json.