Documentation Index Fetch the complete documentation index at: https://mintlify.com/jacob-bd/notebooklm-mcp-cli/llms.txt
Use this file to discover all available pages before exploring further.
Studio commands turn your notebook sources into polished content artifacts using NotebookLM’s AI generation pipeline. A single notebook can produce audio overviews, video summaries, written reports, interactive quizzes, flashcard decks, mind maps, slide presentations, infographics, and data tables — all from the same source material.
Artifact generation is asynchronous and typically takes 1–5 minutes depending on notebook size and artifact type. After starting generation, poll with nlm studio status <notebook-id> until the artifact shows as ready, then download it with nlm download.
The CLI supports two command styles:
# Noun-first
nlm audio create < noteboo k > --format deep_dive --confirm
# Verb-first
nlm create audio < noteboo k > --format deep_dive --confirm
Audio overviews
Generate a podcast-style audio overview from your notebook sources.
nlm audio create < notebook-i d > --confirm
nlm audio create < notebook-i d > --format deep_dive --length long --confirm
Flags
Flag Short Default Description --format-fdeep_diveOverview style: deep_dive, brief, critique, debate --length-ldefaultDuration: short, default, long --focusOptional focus topic to guide the conversation --source-ids-sComma-separated source IDs (default: all) --languageBCP-47 language code (default: NOTEBOOKLM_HL env var or en) --confirm-ySkip confirmation prompt --profile-pProfile to use
Deep Dive Podcast
Brief Overview
Focused Debate
nlm audio create < notebook-i d > \
--format deep_dive \
--length long \
--confirm
Video overviews
Generate a narrated video overview with an animated visual style.
nlm video create < notebook-i d > --confirm
nlm video create < notebook-i d > --format explainer --style classic --confirm
Flags
Flag Short Default Description --format-fexplainerVideo style: explainer, brief, cinematic --style-sauto_selectVisual theme (see table below) --style-promptCustom style description (implies --style custom for explainer/brief; maps to focus for cinematic) --focusFocus topic or creative direction --source-idsComma-separated source IDs --languageBCP-47 language code --confirm-ySkip confirmation prompt --profile-pProfile to use
Available visual styles
Style Description auto_selectLet NotebookLM choose automatically customUse --style-prompt to describe your own classicClean, professional look whiteboardHand-drawn whiteboard aesthetic kawaiiCute Japanese-inspired art animeAnime illustration style watercolorSoft watercolor painting look retro_printVintage print/poster aesthetic heritageClassic heritage illustration paper_craftCut-paper collage style
Explainer with Classic Style
Custom Style Prompt
Cinematic
nlm video create < notebook-i d > \
--format explainer \
--style classic \
--confirm
Reports
Generate a structured written report from notebook sources.
nlm report create < notebook-i d > --format "Briefing Doc" --confirm
Flags
Flag Short Default Description --format-fBriefing DocReport type: Briefing Doc, Study Guide, Blog Post, Create Your Own --promptCustom prompt (required when format is Create Your Own) --source-ids-sComma-separated source IDs --languageBCP-47 language code --confirm-ySkip confirmation prompt --profile-pProfile to use
Briefing Doc
Study Guide
Custom Report
nlm report create < notebook-i d > --format "Briefing Doc" --confirm
Quizzes
Generate a multiple-choice quiz from notebook sources.
nlm quiz create < notebook-i d > --count 10 --difficulty 3 --confirm
Flags
Flag Short Default Description --count-c2Number of questions --difficulty-d2Difficulty level 1–5 (1 = easiest, 5 = hardest) --focus-fFocus prompt to guide question generation --source-ids-sComma-separated source IDs --confirm-ySkip confirmation prompt --profile-pProfile to use
# 10-question quiz, medium difficulty, focused on key concepts
nlm quiz create < notebook-i d > \
--count 10 \
--difficulty 3 \
--focus "Focus on the experimental methodology and results sections" \
--confirm
Flashcards
Generate study flashcards from notebook sources.
nlm flashcards create < notebook-i d > --difficulty hard --confirm
Flags
Flag Short Default Description --difficulty-dmediumCard difficulty: easy, medium, hard --focus-fFocus prompt to guide card generation --source-ids-sComma-separated source IDs --confirm-ySkip confirmation prompt --profile-pProfile to use
Mind maps
Generate a structured mind map of the notebook’s key concepts.
nlm mindmap create < notebook-i d > --confirm
nlm mindmap create < notebook-i d > --title "AI Research Map" --confirm
Flags
Flag Short Default Description --title-tMind MapMind map title --source-ids-sComma-separated source IDs --confirm-ySkip confirmation prompt --profile-pProfile to use
Slide decks
Generate a presentation slide deck from notebook sources.
nlm slides create < notebook-i d > --confirm
Flags
Flag Short Default Description --format-fdetailed_deckDeck format: detailed_deck, presenter_slides --length-ldefaultDeck length: short, default --focusOptional focus topic --source-ids-sComma-separated source IDs --languageBCP-47 language code --confirm-ySkip confirmation prompt --profile-pProfile to use
Revise slides
Apply targeted revisions to individual slides in an existing deck. This creates a new deck — the original is not modified.
# Revise a single slide
nlm slides revise < artifact-i d > \
--slide '1 Make the title larger' \
--confirm
# Revise multiple slides in one command
nlm slides revise < artifact-i d > \
--slide '1 Make the title larger' \
--slide '3 Remove the product roadmap image' \
--slide '5 Add a call-to-action bullet point' \
--confirm
Each --slide value is the slide number followed by the instruction text. Multiple --slide flags are supported.
Infographics
Generate a visual infographic summarising key information from notebook sources.
nlm infographic create < notebook-i d > --confirm
nlm infographic create < notebook-i d > --orientation portrait --style professional --confirm
Flags
Flag Short Default Description --orientation-olandscapePage orientation: landscape, portrait, square --detail-dstandardDetail level: concise, standard, detailed --styleauto_selectVisual style: auto_select, sketch_note, professional, bento_grid, editorial, instructional, bricks, clay, anime, kawaii, scientific --focusOptional focus topic --source-ids-sComma-separated source IDs --languageBCP-47 language code --confirm-ySkip confirmation prompt --profile-pProfile to use
Data tables
Generate a structured data table extracted from notebook sources. The description is a required positional argument that guides the AI in selecting and organising the right information.
nlm data-table create < notebook-i d > "Sales figures by region and quarter" --confirm
Flags
Flag Short Default Description --source-ids-sComma-separated source IDs --languageBCP-47 language code --confirm-ySkip confirmation prompt --profile-pProfile to use
Studio status and management
studio status
List all artifacts for a notebook and their current generation status. Mind map artifacts are included alongside other types.
nlm studio status < notebook-i d >
nlm studio status < notebook-i d > --json
Flags
Flag Short Description --full-aShow all details --json-jOutput as JSON --profile-pProfile to use
studio delete
Permanently delete a studio artifact.
Artifact deletion is irreversible . Use --confirm to skip the interactive prompt in scripts.
nlm studio delete < notebook-i d > < artifact-i d > --confirm
Flags
Flag Short Description --confirm-ySkip confirmation prompt --profile-pProfile to use
studio rename
Rename an existing studio artifact.
nlm studio rename < artifact-i d > "New Artifact Title"
Downloading artifacts
Once an artifact is ready, download it with nlm download. The artifact type determines the default file format.
Artifact type Command Default format Audio nlm download audio.m4aVideo nlm download video.mp4Report nlm download report.mdMind map nlm download mind-map.jsonSlide deck nlm download slide-deck.pdf (also --format pptx)Infographic nlm download infographic.pngData table nlm download data-table.csvQuiz nlm download quiz --format json|markdown|htmlvaries Flashcards nlm download flashcards --format json|markdown|htmlvaries
# Download audio
nlm download audio < notebook-i d > --output podcast.m4a
# Download with a specific artifact ID (when multiple exist)
nlm download audio < notebook-i d > --id < artifact-i d > --output podcast.m4a
# Download slide deck as PPTX
nlm download slide-deck < notebook-i d > --format pptx --output deck.pptx
# Download quiz as HTML
nlm download quiz < notebook-i d > --format html --output quiz.html
# Download flashcards as Markdown
nlm download flashcards < notebook-i d > --format markdown --output cards.md
Complete workflow example
Add sources to a notebook
nlm source add < notebook-i d > --url "https://arxiv.org/abs/2501.00001" --wait
nlm source add < notebook-i d > --file supplementary.pdf --wait
Start audio generation
nlm audio create < notebook-i d > --format deep_dive --length long --confirm
# → Artifact ID: art-abc123
Poll status until ready
# Run repeatedly until status shows "ready"
nlm studio status < notebook-i d >
Or automate polling in a shell loop: while true ; do
status = $( nlm studio status < notebook-i d > --json | jq -r '.artifacts[0].status' )
echo "Status: $status "
[ " $status " = "complete" ] && break
sleep 30
done
Download the artifact
nlm download audio < notebook-i d > --output research-podcast.m4a
Generate a report from the same sources
nlm report create < notebook-i d > --format "Briefing Doc" --confirm
# Wait for completion, then:
nlm download report < notebook-i d > --output briefing.md