Skip to main content

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 <notebook> --format deep_dive --confirm

# Verb-first
nlm create audio <notebook> --format deep_dive --confirm

Audio overviews

Generate a podcast-style audio overview from your notebook sources.
nlm audio create <notebook-id> --confirm
nlm audio create <notebook-id> --format deep_dive --length long --confirm
Flags
FlagShortDefaultDescription
--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
nlm audio create <notebook-id> \
  --format deep_dive \
  --length long \
  --confirm

Video overviews

Generate a narrated video overview with an animated visual style.
nlm video create <notebook-id> --confirm
nlm video create <notebook-id> --format explainer --style classic --confirm
Flags
FlagShortDefaultDescription
--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
StyleDescription
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
nlm video create <notebook-id> \
  --format explainer \
  --style classic \
  --confirm

Reports

Generate a structured written report from notebook sources.
nlm report create <notebook-id> --format "Briefing Doc" --confirm
Flags
FlagShortDefaultDescription
--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
nlm report create <notebook-id> --format "Briefing Doc" --confirm

Quizzes

Generate a multiple-choice quiz from notebook sources.
nlm quiz create <notebook-id> --count 10 --difficulty 3 --confirm
Flags
FlagShortDefaultDescription
--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-id> \
  --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-id> --difficulty hard --confirm
Flags
FlagShortDefaultDescription
--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-id> --confirm
nlm mindmap create <notebook-id> --title "AI Research Map" --confirm
Flags
FlagShortDefaultDescription
--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-id> --confirm
Flags
FlagShortDefaultDescription
--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-id> \
  --slide '1 Make the title larger' \
  --confirm

# Revise multiple slides in one command
nlm slides revise <artifact-id> \
  --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-id> --confirm
nlm infographic create <notebook-id> --orientation portrait --style professional --confirm
Flags
FlagShortDefaultDescription
--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-id> "Sales figures by region and quarter" --confirm
Flags
FlagShortDefaultDescription
--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-id>
nlm studio status <notebook-id> --json
Flags
FlagShortDescription
--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-id> <artifact-id> --confirm
Flags
FlagShortDescription
--confirm-ySkip confirmation prompt
--profile-pProfile to use

studio rename

Rename an existing studio artifact.
nlm studio rename <artifact-id> "New Artifact Title"

Downloading artifacts

Once an artifact is ready, download it with nlm download. The artifact type determines the default file format.
Artifact typeCommandDefault format
Audionlm download audio.m4a
Videonlm download video.mp4
Reportnlm download report.md
Mind mapnlm download mind-map.json
Slide decknlm download slide-deck.pdf (also --format pptx)
Infographicnlm download infographic.png
Data tablenlm download data-table.csv
Quiznlm download quiz --format json|markdown|htmlvaries
Flashcardsnlm download flashcards --format json|markdown|htmlvaries
# Download audio
nlm download audio <notebook-id> --output podcast.m4a

# Download with a specific artifact ID (when multiple exist)
nlm download audio <notebook-id> --id <artifact-id> --output podcast.m4a

# Download slide deck as PPTX
nlm download slide-deck <notebook-id> --format pptx --output deck.pptx

# Download quiz as HTML
nlm download quiz <notebook-id> --format html --output quiz.html

# Download flashcards as Markdown
nlm download flashcards <notebook-id> --format markdown --output cards.md

Complete workflow example

1

Add sources to a notebook

nlm source add <notebook-id> --url "https://arxiv.org/abs/2501.00001" --wait
nlm source add <notebook-id> --file supplementary.pdf --wait
2

Start audio generation

nlm audio create <notebook-id> --format deep_dive --length long --confirm
# → Artifact ID: art-abc123
3

Poll status until ready

# Run repeatedly until status shows "ready"
nlm studio status <notebook-id>
Or automate polling in a shell loop:
while true; do
  status=$(nlm studio status <notebook-id> --json | jq -r '.artifacts[0].status')
  echo "Status: $status"
  [ "$status" = "complete" ] && break
  sleep 30
done
4

Download the artifact

nlm download audio <notebook-id> --output research-podcast.m4a
5

Generate a report from the same sources

nlm report create <notebook-id> --format "Briefing Doc" --confirm
# Wait for completion, then:
nlm download report <notebook-id> --output briefing.md

Build docs developers (and LLMs) love