Agent skill

Notebooklm

by Mathews-Tom in Mathews-Tom/armory

Full NotebookLM API via notebooklm-py CLI: create notebooks, add sources, generate podcasts, videos, infographics, slides, quizzes, flashcards, mind maps.

MITAuto-check passedKnowledge Management

Install Notebooklm

skills CLI
$ npx skills add Mathews-Tom/armory --skill notebooklm -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install Mathews-Tom/armory notebooklm --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/Mathews-Tom/armory.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/notebooklm .claude/skills/notebooklm && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
notebooklm
GitHub stars
328
Token cost
~4k tokens
SKILL.md length
1,151 words
Files
2
Skills in repo
80
Repo updated
First seen
Licence
MIT

At a glance

Full NotebookLM API via notebooklm-py CLI: create notebooks, add sources, generate podcasts, videos, infographics, slides, quizzes, flashcards, mind maps.

  • Works in 6 steps: notebooklm create "Research: [topic]"… → notebooklm source add "https://..."… → notebooklm source list --json — wait… → …
  • Create a podcast
  • SKILL.md covers Prerequisites, Quick Reference, Autonomy Rules and Generation Types, plus 7 more sections
  • Calls uv; reaches youtube.com and url1.com

What it does

Notebooklm is an agent skill from Mathews-Tom/armory. 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".

Its SKILL.md is about 4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `evals/cases.yaml`).

It sits in Knowledge Management, covering Source-grounded notebooks, Infographics and Podcasting. It works with NotebookLM. The repository describes itself as: Curated, production-grade skills for AI coding agents. Battle-tested workflows for developers who use AI seriously. The licence is MIT.

When your agent uses it

  • Create a podcast
  • Generate flashcards
  • Generate infographic

Example prompts

  • “notebooklm”
  • “create a podcast”
  • “audio overview”
  • “/notebooklm”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. notebooklm create "Research: [topic]" --json — capture notebook ID
  2. notebooklm source add "https://..." --json for each source — capture source IDs
  3. notebooklm source list --json — wait until all status=ready
  4. notebooklm generate audio "Focus on [angle]" --json — capture artifact ID
  5. notebooklm artifact wait — blocks until complete
  6. notebooklm download audio ./podcast.mp3

What it can do on your machine

Read from SKILL.md and the folder at commit 4594fb7. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • uv

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • youtube.com
    • url1.com
    • url2.com

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Notebooklm loads about 4k tokens when it runs. Until then it costs about 73 tokens; SKILL.md has 1,151 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~73
When it runs · the whole SKILL.md, loaded when a task matches
~4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from Mathews-Tom/armory at commit 4594fb7, republished under its MIT licence (© Mathews-Tom). 1,151 words, ~4,011 tokens.

Download SKILL.mdSave it as .claude/skills/notebooklm/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
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
metadata.category
research
metadata.tags
notebooklm, podcast, flashcards, source-analysis
metadata.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
bash
uv tool install notebooklm-py
Authentication (one-time)
bash
notebooklm login          # Opens browser for Google OAuth
notebooklm list           # Verify authentication works

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

Verify Setup
bash
notebooklm --version
notebooklm status         # Shows "Authenticated as: email@..."
notebooklm list --json    # Should return valid JSON
CI/CD and Parallel Agents
VariablePurpose
NOTEBOOKLM_HOMECustom config directory (default: ~/.notebooklm)
NOTEBOOKLM_AUTH_JSONInline 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

TaskCommand
Authenticatenotebooklm login
Diagnose authnotebooklm auth check --test
List notebooksnotebooklm list
Create notebooknotebooklm create "Title"
Set contextnotebooklm use <notebook_id>
Show contextnotebooklm status
Add URL sourcenotebooklm source add "https://..."
Add filenotebooklm source add ./file.pdf
Add YouTubenotebooklm source add "https://youtube.com/..."
List sourcesnotebooklm source list
Wait for sourcenotebooklm 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 statusnotebooklm research status
Wait for researchnotebooklm research wait --import-all
Chatnotebooklm 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 fulltextnotebooklm source fulltext <source_id>
Get source guidenotebooklm source guide <source_id>
Generate podcastnotebooklm generate audio "instructions"
Generate videonotebooklm generate video "instructions"
Generate quiznotebooklm generate quiz
Generate infographicnotebooklm generate infographic
Generate slide decknotebooklm generate slide-deck
Generate reportnotebooklm generate report
Generate mind mapnotebooklm generate mind-map
Generate data tablenotebooklm generate data-table "description"
Generate flashcardsnotebooklm generate flashcards
Check artifact statusnotebooklm artifact list
Wait for completionnotebooklm artifact wait <artifact_id>
Download audionotebooklm download audio ./output.mp3
Download videonotebooklm download video ./output.mp4
Download reportnotebooklm download report ./report.md
Download mind mapnotebooklm download mind-map ./map.json
Download data tablenotebooklm download data-table ./data.csv
Download quiznotebooklm download quiz quiz.json
Download quiz (markdown)notebooklm download quiz --format markdown quiz.md
Download flashcardsnotebooklm download flashcards cards.json
Download infographicnotebooklm download infographic ./infographic.png
Download slide decknotebooklm download slide-deck ./slides.pdf
List languagesnotebooklm language list
Set languagenotebooklm language set zh_Hans

Partial IDs: Use the first 6+ characters of UUIDs. Must be a unique prefix. Prefer full UUIDs in automation.

Autonomy Rules

Run without confirmation:

  • status, auth check, list, source list, artifact list, language list/get/set
  • use <id>, create, ask "...", source add
  • source wait, artifact wait, research wait/status (in subagent context)

Confirm before running:

  • delete — destructive
  • generate * — long-running, may fail due to rate limits
  • download * — writes to filesystem
  • artifact wait, source wait, research wait — long-running (in main conversation)

Generation Types

All generate commands support:

  • -s, --source to use specific source(s) instead of all
  • --language to override output language
  • --json for machine-readable output (returns task_id and status)
  • --retry N for automatic retry with exponential backoff
TypeCommandKey OptionsDownload Format
Podcastgenerate audio--format [deep-dive|brief|critique|debate], --length [short|default|long].mp3
Videogenerate video--format [explainer|brief], --style [auto|classic|whiteboard|kawaii|anime|watercolor|retro-print|heritage|paper-craft].mp4
Slide Deckgenerate slide-deck--format [detailed|presenter], --length [default|short].pdf
Infographicgenerate infographic--orientation [landscape|portrait|square], --detail [concise|standard|detailed].png
Reportgenerate report--format [briefing-doc|study-guide|blog-post|custom].md
Mind Mapgenerate mind-map(sync, instant).json
Data Tablegenerate data-tabledescription required.csv
Quizgenerate quiz--difficulty [easy|medium|hard], --quantity [fewer|standard|more].json/.md/.html
Flashcardsgenerate flashcards--difficulty [easy|medium|hard], --quantity [fewer|standard|more].json/.md/.html

Features Beyond the Web UI

FeatureCommandDescription
Batch downloadsdownload <type> --allDownload all artifacts of a type at once
Quiz/Flashcard exportdownload quiz --format jsonExport as JSON, Markdown, or HTML
Mind map extractiondownload mind-mapHierarchical JSON for visualization tools
Data table exportdownload data-tableStructured tables as CSV
Source fulltextsource fulltext <id>Retrieve the indexed text content of any source
Programmatic sharingshare commandsManage sharing permissions without the UI

JSON Output Formats

Use --json for machine-readable output:

Create notebook:

json
{ "id": "abc123de-...", "title": "Research" }

Add source:

json
{ "source_id": "def456...", "title": "Example", "status": "processing" }

Generate artifact:

json
{ "task_id": "xyz789...", "status": "pending" }

Chat with references:

json
{
  "answer": "X is... [1] [2]",
  "conversation_id": "...",
  "references": [
    {
      "source_id": "abc123...",
      "citation_number": 1,
      "cited_text": "Relevant passage..."
    }
  ]
}

Source list:

json
{
  "sources": [
    { "id": "...", "title": "...", "status": "ready|processing|error" }
  ]
}

Artifact list:

json
{
  "artifacts": [
    {
      "id": "...",
      "title": "...",
      "type": "Audio Overview",
      "status": "in_progress|pending|completed|unknown"
    }
  ]
}

Common Workflows

Research to Podcast
  1. notebooklm create "Research: [topic]" --json — capture notebook ID
  2. notebooklm source add "https://..." --json for each source — capture source IDs
  3. notebooklm source list --json — wait until all status=ready
  4. notebooklm generate audio "Focus on [angle]" --json — capture artifact ID
  5. notebooklm artifact wait <artifact_id> — blocks until complete
  6. notebooklm download audio ./podcast.mp3
Show full SKILL.md (469 more words)Show less
Document Analysis
  1. notebooklm create "Analysis: [project]"
  2. notebooklm source add ./doc.pdf
  3. notebooklm ask "Summarize the key points"
  4. Continue chatting as needed
Bulk Import
  1. notebooklm create "Collection: [name]"
  2. Add sources (max 50 per notebook):
    bash
    notebooklm source add "https://url1.com" --json
    notebooklm source add "https://url2.com" --json
    notebooklm source add ./local-file.pdf --json
  3. notebooklm source list --json to verify

Supported source types: PDFs, YouTube URLs, web URLs, Google Docs, text files, Markdown, Word docs, audio files, video files, images.

Deep Web Research
  1. notebooklm create "Research: [topic]"
  2. Start deep research: notebooklm source add-research "topic" --mode deep --no-wait
  3. Wait: notebooklm research wait --import-all --timeout 300
  4. Sources auto-imported when research completes

Modes: --mode fast (5-10 sources, seconds) vs --mode deep (20+ sources, 2-5 min). Search from: --from web (default) or --from drive (Google Drive).

Subagent Pattern for Long Operations

For non-blocking generation, spawn a background agent:

  1. Run notebooklm generate audio "..." --json — parse artifact_id
  2. Spawn a Task agent to wait and download:
    Wait for artifact {artifact_id} in notebook {notebook_id} to complete.
    Use: notebooklm artifact wait {artifact_id} -n {notebook_id} --timeout 600
    Then: notebooklm download audio ./podcast.mp3 -a {artifact_id} -n {notebook_id}
  3. Main conversation continues while agent waits

Processing Times

OperationTypical TimeSuggested Timeout
Source processing30s - 10 min600s
Research (fast)30s - 2 min180s
Research (deep)15 - 30+ min1800s
Mind mapinstant (sync)n/a
Notesinstantn/a
Quiz, flashcards5 - 15 min900s
Report, data table5 - 15 min900s
Audio generation10 - 20 min1200s
Video generation15 - 45 min2700s

Error Handling

ErrorCauseAction
Auth/cookie errorSession expirednotebooklm auth check then notebooklm login
"No notebook context"Context not setUse -n <id> flag or notebooklm use <id>
"No result found for RPC ID"Rate limitingWait 5-10 min, retry
GENERATION_FAILEDGoogle rate limitWait and retry later
Download failsGeneration incompleteCheck artifact list for status
Invalid notebook/source IDWrong IDRun notebooklm list to verify
RPC protocol errorGoogle changed APIsMay need CLI update (uv tool upgrade notebooklm-py)

Exit codes: 0 = success, 1 = error, 2 = timeout (wait commands only).

Reliable operations: Notebooks, sources, chat, mind map, report, data table. May hit rate limits: Audio, video, quiz, flashcards, infographic, slide deck.

Language Configuration

Language is a global setting affecting all notebooks.

bash
notebooklm language list              # 80+ supported languages
notebooklm language get               # Current setting
notebooklm language set ja            # Set globally
notebooklm generate audio --language ja  # Override per command

Common codes: en, zh_Hans, zh_Hant, ja, ko, es, fr, de, pt_BR.

Limitations

  • Unofficial API: Uses browser automation via notebooklm-py. May break if Google changes NotebookLM internals. Not affiliated with Google.
  • 50 sources per notebook: Hard limit from NotebookLM.
  • Rate limiting: Generation endpoints are rate-limited by Google. No workaround beyond waiting.
  • Auth expiry: Google OAuth sessions expire. Re-run notebooklm login when auth fails.
  • No streaming: Chat responses are returned in full, not streamed.
  • Single-agent context: notebooklm use writes to a shared file. Use -n flags for parallel workflows.

© Mathews-Tom, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/notebooklm of Mathews-Tom/armory.

  • SKILL.md
  • evals/cases.yaml

Open the folder on GitHubat commit 4594fb7

Compare with similar skills

Notebooklm next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Notebooklm compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Notebooklm this skillMathews-Tom/armory328—~4kAutomated safety check: PassMIT
Nlm Skilliusztinpaul/ai-research-os-workshop1791 repos~6.9kAutomated safety check: PassMIT
NotebookLM CLI Guidejacob-bd/notebooklm-cli255—~3.4kAutomated safety check: WarnMIT
Notebooklmalirezarezvani/claude-skills28k—~4kAutomated safety check: PassMIT
Notebooklm CLIItamarZand88/CLI-Anything-WEB231—~997Automated safety check: PassMIT
Multi-Source to NotebookLM Processorjoeseesun/qiaomu-anything-to-notebooklm6.2k—~3.6kAutomated safety check: PassMIT

Similar skills

  • Nlm Skill

    iusztinpaul/ai-research-os-workshop

    Expert guide for the NotebookLM CLI (nlm) and MCP server - interfaces for Google NotebookLM.

    179 GitHub starsUsed in 1 repo~6.9k tokens
    Knowledge ManagementAuto-check passed
  • NotebookLM CLI Guide

    jacob-bd/notebooklm-cli

    Guides use of the nlm command-line tool to automate Google NotebookLM: notebooks, sources, research, one-shot questions and generated podcasts, reports, quizzes and slides.

    255 GitHub stars~3.4k tokensUpdated 4 mo ago
    Knowledge ManagementAuto-check: warnings
  • Notebooklm

    alirezarezvani/claude-skills

    Browser automation skill for controlling Google's NotebookLM.

    28k GitHub stars~4k tokensUpdated 1 mo ago
    Knowledge ManagementAuto-check passed
  • Notebooklm CLI

    ItamarZand88/CLI-Anything-WEB

    Drives Google NotebookLM via the cli-web-notebooklm command-line tool — create and manage notebooks, add URL/text sources, ask questions grounded in the sources, and generate/download artifacts…

    231 GitHub stars~997 tokensUpdated 7 days ago
    Knowledge ManagementAuto-check passed
  • Multi-Source to NotebookLM Processor

    joeseesun/qiaomu-anything-to-notebooklm

    Collects content from WeChat articles, web pages, YouTube, podcasts, documents and more, uploads it to NotebookLM and generates podcasts, slides or mind maps.

    6.2k GitHub stars~3.6k tokensUpdated 3 days ago
    Knowledge ManagementAuto-check passed
  • NotebookLM Research Workflow

    claude-world/notebooklm-skill

    Creates NotebookLM notebooks from URLs, text and files, asks cited questions, runs web research and generates audio, slides, quizzes and other artifacts.

    465 GitHub stars~1.8k tokensUpdated 2 mo ago
    Knowledge ManagementAuto-check passed

More from Mathews-Tom/armory

All 80 skills in this repo
  • Architecture Reviewer

    Mathews-Tom/armory

    Architecture reviews across 7 dimensions (structural, scalability, enterprise readiness, performance, security, ops, data) with scored reports.

    328 GitHub stars~4.6k tokensUpdated 2 days ago
    Auto-check passed
  • Concept To Image

    Mathews-Tom/armory

    Turn concepts into static HTML visuals exported as PNG or SVG files via HTML/CSS/SVG.

    328 GitHub stars~2.6k tokensUpdated 2 days ago
    Auto-check passed
  • Watch

    Mathews-Tom/armory

    A skill your agent uses when analyzing an existing video URL or local recording: "watch this video", "analyze youtube video", "summarize this video", "youtube transcript", "find this moment", "what…

    328 GitHub stars~2.8k tokensUpdated 2 days ago
    Auto-check passed
  • Code Refiner

    Mathews-Tom/armory

    Deep code simplification and refactoring preserving behavior across Python, Go, TypeScript, Rust.

    328 GitHub stars~3.1k tokensUpdated 2 days ago
    Auto-check passed
  • Concept To Video

    Mathews-Tom/armory

    Turn concepts into animated explainer videos using Manim (Python) with MP4/GIF output, audio overlay, multi-scene composition.

    328 GitHub stars~4.9k tokensUpdated 2 days ago
    Auto-check passed
  • Decision Map

    Mathews-Tom/armory

    Maps the unresolved architecture, policy, and scope decisions that must be answered before planning can start: one durable decision ticket per question on the issue tracker, typed and blocker-linked…

    328 GitHub stars~2.7k tokensUpdated 2 days ago
    Auto-check passed

Works with

Questions about Notebooklm

What does Notebooklm do?

Full NotebookLM API via notebooklm-py CLI: create notebooks, add sources, generate podcasts, videos, infographics, slides, quizzes, flashcards, mind maps. Notebooklm is an agent skill from Mathews-Tom/armory. Full NotebookLM API via notebooklm-py CLI: create notebooks, add sources, generate podcasts, videos, infographics, slides, quizzes, flashcards, mind maps.

When should I use Notebooklm?

Notebooklm fits situations like: create a podcast; generate flashcards; generate infographic.

How do I install Notebooklm in Claude Code?

Run `npx skills add Mathews-Tom/armory --skill notebooklm -a claude-code`. Or copy the skill folder (skills/notebooklm in Mathews-Tom/armory) into .claude/skills/notebooklm in your project. Claude Code loads it when a task matches its description.

How do I install Notebooklm in Codex?

Run `npx skills add Mathews-Tom/armory --skill notebooklm -a codex`. Or copy the skill folder (skills/notebooklm in Mathews-Tom/armory) into .agents/skills/notebooklm in your project. Codex loads it when a task matches its description.

Can I use Notebooklm in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add Mathews-Tom/armory --skill notebooklm -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/notebooklm, .gemini/skills/notebooklm, .github/skills/notebooklm and .opencode/skills/notebooklm in your project.

What does Notebooklm need to run?

Going by SKILL.md and its folder, Notebooklm needs the command-line tools its instructions call (uv).

Does Notebooklm access the network?

SKILL.md names 3 domains. In commands or code: youtube.com, url1.com and url2.com; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Notebooklm safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Notebooklm use?

Notebooklm is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Notebooklm use?

About 4k tokens (SKILL.md is roughly 16k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Notebooklm?

Skills that share tags, products or a category with Notebooklm: Nlm Skill (iusztinpaul/ai-research-os-workshop, 179 stars), NotebookLM CLI Guide (jacob-bd/notebooklm-cli, 255 stars), Notebooklm (alirezarezvani/claude-skills, 28k stars) and Notebooklm CLI (ItamarZand88/CLI-Anything-WEB, 231 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Notebooklm?

Mathews-Tom (a GitHub user) maintains it in Mathews-Tom/armory, which has 328 GitHub stars. The repository holds 80 skills in this directory. The repository was last updated on October 6, 2026.

Source: Mathews-Tom/armory on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.