SkillsMay 13, 2026·2 min read

notebooklm-py — NotebookLM CLI + Python API Skill

notebooklm-py provides a CLI + Python API for NotebookLM with agent hooks; verified 13,142★ and uses Playwright Chromium for browser login.

Agent ready

Safe staging for this asset

This asset is staged first. The copied prompt tells the agent to inspect the staged files and ask before activating scripts, MCP config, or global config.

Stage only · 17/100Policy: stage
Agent surface
Any MCP/CLI agent
Kind
CLI Tool
Install
Stage only
Trust
Trust: Established
Entrypoint
Asset
Safe staging command
npx -y tokrepo@latest install 7a9502e3-58ab-59a1-b9d5-f7e80b83a4b3 --target codex

Stages files first; activation requires review of the staged README and plan.

Intro

notebooklm-py provides a CLI + Python API for NotebookLM with agent hooks; verified 13,142★ and uses Playwright Chromium for browser login.

Best for: Researchers and builders automating NotebookLM ingestion, chat, and artifact downloads from scripts

Works with: Python 3.10+ (per README), Playwright Chromium for login, and NotebookLM web accounts

Setup time: 12-25 minutes

Key facts (verified)

  • GitHub: 13142 stars · 1826 forks · pushed 2026-05-13.
  • License: MIT · owner avatar + repo URL verified via GitHub API.
  • README-backed entrypoint: notebooklm login.

Main

  • Treat auth as a first-class step: run notebooklm auth check --test after login, and keep a known-good storage state for CI/headless usage.

  • Start with a small notebook + 1–2 sources, then add generate / download flows only after you can reliably ask with citations.

  • Because this is an unofficial wrapper over undocumented APIs, pin versions in automation and expect breakage; keep troubleshooting links near your runbooks.

Source-backed notes

  • README explicitly warns it is unofficial and uses undocumented Google APIs that may break without notice.
  • README shows CLI flows: create/use notebooks, add sources, ask questions, generate artifacts, and download outputs (MP3/MP4/PDF/PNG/CSV/JSON/Markdown).
  • README notes a browser-based login via Playwright Chromium and includes a size/time hint for the Chromium install (~170MB; ~30–90s).

FAQ

  • Is this affiliated with Google?: No — README says it’s unofficial and not affiliated with Google.
  • Can I use it headless?: Yes — README documents cookie/storage-state based auth paths, but you should validate with auth check.
  • What breaks most often?: Auth and internal endpoints; pin versions and keep troubleshooting docs handy.
🙏

Source & Thanks

Source: https://github.com/teng-lin/notebooklm-py > License: MIT > GitHub stars: 13142 · forks: 1826

Discussion

Sign in to join the discussion.
No comments yet. Be the first to share your thoughts.

Related Assets