teng-lin/notebooklm-py

Unofficial Python API and agentic skill for Google Gemini Notebook. Full programmatic access to NotebookLM's features—including capabilities the web UI doesn't expose—via Python, CLI, and AI agents like Claude Code, Codex, and OpenClaw.

What it solves

notebooklm-py provides programmatic access to Google's NotebookLM (now Gemini Notebook), allowing users to bypass the web UI to automate research, content generation, and knowledge management. It enables the integration of NotebookLM's grounded AI capabilities into AI agents (like Claude Code or Codex), shell scripts, and custom Python pipelines, effectively turning the service into a scriptable "memory layer" or synthesis engine for other LLMs.

How it works

The library acts as an unofficial Python API and CLI wrapper around undocumented Google APIs. It supports multiple authentication methods, including interactive browser login, cookie imports from existing browsers, and a master-token system for headless server environments. It can interact with NotebookLM to manage notebooks, upload various source types (URLs, PDFs, YouTube videos, Google Drive files), and trigger the generation of cited answers and multimedia artifacts.

Who it’s for

  • AI Agent Developers: Those wanting to give agents persistent, grounded memory or a "project brain" without managing their own vector databases.
  • Researchers and Students: Users needing to automate the bulk import of sources and the generation of study aids like quizzes, flashcards, and podcasts.
  • Automation Engineers: People building headless pipelines for scheduled audio briefings or automated incident runbook generation.
  • Knowledge Managers: Users syncing NotebookLM's synthesized outputs into tools like Obsidian.

Highlights

  • Full Feature Coverage: Programmatic control over notebooks, sources, chat, notes, and sharing permissions.
  • Diverse Artifact Generation: Generates audio overviews (podcasts), videos, slide decks, infographics, quizzes, flashcards, reports, and data tables.
  • Extended Capabilities: Offers features not found in the web UI, such as batch downloads of artifacts and structured exports (JSON, CSV, Markdown) for quizzes and mind maps.
  • Agent-Ready: Includes built-in skills for Claude Code and Codex, and an MCP server for integration with Claude Desktop and ChatGPT.
  • Flexible Auth: Supports multi-account profiles and a master-token system for unattended, headless operation.

Related

  • Project
  • Project
  • Dispatch
  • Project
  • Project