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

This asset can be read and installed directly by agents

TokRepo exposes a universal CLI command, install contract, metadata JSON, adapter-aware plan, and raw content links so agents can judge fit, risk, and next actions.

Native · 98/100Policy: allow
Agent surface
Any MCP/CLI agent
Kind
Skill
Install
Pipx
Trust
Trust: Established
Entrypoint
notebooklm login
Universal CLI install command
npx tokrepo install 7a9502e3-58ab-59a1-b9d5-f7e80b83a4b3
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