notebooklm-cli

Operate NotebookLM via CLI for source management, iterative Q&A, and content generation.

6|1|Updated May 11, 2026
One-click install
npx skills add https://github.com/yakeworld/Synthos --skill notebooklm-cli-yakeworld
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: notebooklm-cli
Source: https://github.com/yakeworld/Synthos/tree/main/skills/extended/external-automation/automation-skills/productivity/notebooklm-cli
Command: npx skills add https://github.com/yakeworld/Synthos --skill notebooklm-cli-yakeworld

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve? Conducting literature-grounded research and paper quality audits requires deep reasoning over many sources, but local models lack that capacity and cloud APIs are costly. This Skill turns NotebookLM into a free Gemini-grade knowledge brain, driven entirely through its CLI, with battle-tested protocols that avoid the tool's many pitfalls (upload failures, timeouts, security-scan blocks, project pollution). ## Core Features & Use Cases - Source & Notebook Management: Create notebooks, upload PDFs/Markdown/Drive files, rename sources to BibTeX keys via UUID prefixes, and clean error or duplicate sources. - Iterative Q&A Protocol: One-question-per-round method (Q1 domain map through Q6 experiment design) with 90s+ timeouts, pure-ASCII prompts, and three-step answer verification. - Content Generation: Generate reports, mind maps, infographics, quizzes, flashcards, audio, slide decks, and video, with per-type download commands and timing expectations. - Layer B Paper Quality Audit: Full workflow for auditing papers against a five-dimension rubric with T1/T2 thresholds, plus a manual fallback when Google services are unreachable. - Use Case: Upload a manuscript PDF and its references.bib to a fresh notebook, send a pure-English audit prompt, and save a scored quality report to 07-quality/layer-b-report.md. ## Quick Start Ask the agent to create a fresh NotebookLM notebook, upload your paper PDF after checking its text layer with pdftotext, then run an English Layer B quality audit question with a 90-second timeout.

Frequently Asked Questions about notebooklm-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I use the NotebookLM CLI for literature Q&A?

Select a notebook with notebooklm use, then send one question per round via notebooklm ask, letting each answer decide the next question. Set the timeout to at least 90 seconds since responses take 30-60 seconds, and never run parallel asks in the same project.

How to upload PDFs to NotebookLM from the command line?

Run notebooklm source add file.pdf after checking the text layer with pdftotext file.pdf - | wc -c. If the character count is near zero or the upload returns status error, extract the text and upload with --type text, or use the arXiv URL directly.

Why does notebooklm ask fail with Chinese prompts?

Prompts containing Chinese characters can trigger a confusable Unicode security scan that blocks the request at HIGH severity. Convert the prompt to pure English ASCII before sending to avoid the interception.

Can NotebookLM CLI upload large Markdown or text files?

Files over roughly 80KB fail when passed via shell command substitution like $(cat file). Use Python subprocess instead, strip YAML frontmatter first, and note that files above ~10KB may still be unreliable through the CLI.

What to do when NotebookLM is unreachable from my network?

Diagnose with curl to notebooklm.google.com; a 000 response means Google is blocked. Then use the manual fallback: extract the paper text with pdftotext and perform the five-dimension quality evaluation yourself, keeping the same scoring thresholds.

Why does notebooklm source delete not remove sources?

Source deletion is unreliable in v0.4.x and can report success while the source persists, and shared projects only allow deletion for owners. The safe practice is to create a fresh notebook for each audit instead of cleaning an old one.