name: notebooklm-cli
description: Comprehensive CLI for Google NotebookLM including notebooks, sources, audio podcasts, reports, quizzes, flashcards, mind maps, slides, infographics, videos, and data tables. Use when working with NotebookLM programmatically: managing notebooks/sources, generating audio overviews (podcasts), creating study materials (quizzes, flashcards), producing presentations (slides, infographics), or querying sources via chat.
NotebookLM CLI
Overview
This skill provides complete access to Google NotebookLM through a command-line interface. Manage notebooks, sources, and generate various content formats including audio podcasts, reports, quizzes, flashcards, mind maps, slides, infographics, videos, and data tables.
When to Use This Skill
Use this skill when:
- Managing NotebookLM notebooks and sources programmatically
- Generating audio overviews (podcasts) from notebook sources
- Creating study materials: quizzes, flashcards, reports
- Producing visual content: slides, infographics, mind maps, videos
- Querying sources via chat or one-shot questions
- Researching and importing new sources automatically
Quick Start
Authentication
nlm login
Launches Chrome, navigates to NotebookLM, and extracts session cookies. Requires Google Chrome installed.
List Notebooks
nlm notebook list
Create Notebook and Add Sources
nlm notebook create "My Research"
nlm source add <notebook-id> --url "https://example.com/article"
nlm source add <notebook-id> --text "Your content here" --title "My Notes"
Generate Content (All Types)
All generation commands require --confirm or -y:
nlm audio create <id> --confirm
nlm report create <id> --confirm
nlm quiz create <id> --confirm
nlm flashcards create <id> --confirm
nlm mindmap create <id> --confirm
nlm slides create <id> --confirm
nlm infographic create <id> --confirm
nlm video create <id> --confirm
nlm data-table create <id> "description" --confirm
Authentication
| Command | Description |
|---|
nlm login | Authenticate with NotebookLM (opens Chrome) |
nlm login --check | Verify current credentials |
nlm auth status | Check session validity |
nlm auth list | List all profiles |
nlm auth delete <profile> --confirm | Delete a profile |
nlm login --profile <name> | Login to specific profile |
Sessions last ~20 minutes. Re-authenticate with nlm login if commands fail.
Notebook Management
| Command | Description |
|---|
nlm notebook list | List all notebooks |
nlm notebook create "Title" | Create a new notebook |
nlm notebook get <id> | Get notebook details |
nlm notebook describe <id> | AI-generated summary |
nlm notebook query <id> "question" | Chat with sources |
nlm notebook delete <id> --confirm | Delete a notebook |
Source Management
| Command | Description |
|---|
nlm source list <notebook-id> | List sources in notebook |
nlm source list <notebook-id> --drive | Show Drive sources with freshness |
nlm source add <id> --url "..." | Add URL or YouTube source |
nlm source add <id> --text "..." --title "..." | Add pasted text |
nlm source add <id> --drive <doc-id> | Add Google Drive document |
nlm source describe <source-id> | AI summary of source |
nlm source content <source-id> | Get raw text content |
nlm source stale <notebook-id> | List outdated Drive sources |
nlm source sync <notebook-id> --confirm | Sync Drive sources |
Content Generation
All generation commands require --confirm or -y:
Media Types
| Command | Output |
|---|
nlm audio create <id> --confirm | Audio podcast overview |
nlm report create <id> --confirm | Briefing doc or study guide |
nlm quiz create <id> --confirm | Quiz questions |
nlm flashcards create <id> --confirm | Flashcards |
nlm mindmap create <id> --confirm | Mind map |
nlm slides create <id> --confirm | Slide deck |
nlm infographic create <id> --confirm | Infographic |
nlm video create <id> --confirm | Video overview |
nlm data-table create <id> "description" --confirm | Data table extraction |
Studio (Artifact Management)
| Command | Description |
|---|
nlm studio status <notebook-id> | List all generated artifacts |
nlm studio delete <notebook-id> <artifact-id> --confirm | Delete an artifact |
Chat
| Command | Description |
|---|
nlm chat start <notebook-id> | Start interactive REPL session |
nlm chat configure <notebook-id> | Configure chat goal and response style |
nlm notebook query <id> "question" | One-shot question (no session) |
Chat REPL commands: /sources, /clear, /help, /exit
Research
| Command | Description |
|---|
nlm research start "query" --notebook-id <id> | Web search (~30s) |
nlm research start "query" --notebook-id <id> --mode deep | Deep research (~5min) |
nlm research start "query" --notebook-id <id> --source drive | Search Google Drive |
nlm research status <notebook-id> | Check research progress |
nlm research import <notebook-id> <task-id> | Import discovered sources |
Aliases (UUID Shortcuts)
nlm alias set myproject <uuid>
nlm notebook get myproject
nlm alias list
nlm alias get myproject
nlm alias delete myproject
Output Formats
Most list commands support multiple formats:
nlm notebook list
nlm notebook list --json
nlm notebook list --quiet
nlm notebook list --title
nlm notebook list --full
Profiles (Multiple Accounts)
nlm login --profile work
nlm notebook list --profile work
nlm auth list
nlm auth delete work --confirm
Configuration
nlm config show
nlm config get <key>
nlm config set <key> <value>
AI Documentation
For AI assistants, generate comprehensive documentation:
nlm --ai
Outputs 400+ lines covering all commands, authentication flow, error handling, task sequences, and automation tips.
References
