notebooklm-py — What is it?

The 'notebooklm-py' project provides a Python API for accessing Google NotebookLM's features programmatically, enabling developers to integrate advanced AI research and content generation capabilities into their applications.

⭐ 17,360 Stars 🍴 2,362 Forks Python — Author: teng-lin
Source: Official README and linked documentation View on GitHub →

Why it matters

This project is being discussed because its ability to offer full programmatic access to NotebookLM's features, including those not exposed by the web UI. It addresses the pain point of limited access to advanced AI capabilities, fills the gap in integrating such features into custom applications, and differs through its support for various AI agents and content generation formats.

Source: Official README and linked documentation

Core Features

AI Agent Integration

Supports integration with AI agents like Claude Code, Codex, and OpenClaw, providing a framework for orchestrating complex tasks and use NotebookLM's capabilities.

Source: Official README and linked documentation
Research Automation

Automates the process of importing sources, running research queries, and extracting insights programmatically, facilitating the creation of repeatable research pipelines.

Source: Official README and linked documentation
Content Generation

Enables the generation of various content formats such as audio overviews, videos, slide decks, quizzes, and infographics, offering full control over formats and styles.

Source: Official README and linked documentation
Downloads & Export

Supports downloading and exporting generated artifacts in multiple formats, including MP3, MP4, PDF, PNG, CSV, JSON, and Markdown, with batch download capabilities.

Source: Official README and linked documentation

Architecture

The architecture is modular, with a clear separation of concerns. It includes a Python SDK, CLI, MCP server, and REST server. The project utilizes design patterns such as dependency injection and separation of presentation and logic, with a focus on data flow between different components and efficient use of Google's infrastructure for storage and recall.

Source: Official repository tree and dependency files

Project Knowledge Graph

Knowledge graph: project (center) + core features (inner hexagons) + key dependencies (outer chips) httpx click rich filelock AI Agent Integration Research Automation Content Generation Downloads & Export notebooklm-py Project Core feature Key dependency

Tech Stack

LanguagePythonFrameworkNot specified, but likely includes frameworks for HTTP requests, CLI interfaces, and possibly machine learning libraries
httpxclickrichfilelock
Docker, likely with a focus on containerization and orchestration for deployment
Source: Official repository tree and dependency files

Quick Start

pip install notebooklm-py python your_script.py
Source: Official README and linked documentation

Use Cases

This project is suitable for developers looking to integrate advanced AI research and content generation capabilities into their applications. It is useful in scenarios such as building AI-powered research tools, content creation platforms, and educational applications that require automated content generation and analysis.

Source: Official README and linked documentation

Strengths & Limitations

Strengths

  • Offers full programmatic access to NotebookLM's features, enabling advanced integration and automation.
  • Supports a wide range of content generation formats and AI agent integrations.
  • Provides export and download capabilities for generated artifacts.

Limitations

  • Being an unofficial library, it relies on undocumented Google APIs that may change without notice, posing a risk of API breakage.
  • Heavy usage may be throttled due to rate limits.
Source: Official README and linked documentation

Latest Release

The current stable release is v0.8.2, published on 2026-09-02. It adds a full Android gRPC backend, chat task status and cancellation, notebook copying, paragraph search, Play Books sources, and research findings. The release also warns that a persistent master token has broader authority than a cookie snapshot.

Source: github.com/teng-lin/notebooklm-py/releases/tag/v0.8.2

Verification and evidence

status: docs-only  |  checked_at: 2026-09-23  |  environment: Docs only. Reviewed the official README, v0.8.2 release, and Google's rename announcement.  |  limitations: The package and Chromium were not installed. Google login did not occur, no cookie or master token was read, no notebook was created, no source was uploaded, and no MCP or REST service or request was started.  |  observed_output: The current stable version is v0.8.2, dated 2026-09-02. The official release explicitly warns about the Android backend's master-token risk and says both backends depend on unpublished APIs.

Source: github.com/teng-lin/notebooklm-py/releases/tag/v0.8.2;https://github.…

Comparison

notebooklm-py adds scripting, bulk export, MCP, and REST access around the Google product, at the cost of relying on a community wrapper for unpublished APIs. Google's announcement identifies Gemini Notebook as a separate official product and describes synchronization with Gemini apps and Search. That announcement does not provide compatibility guarantees or support for notebooklm-py.

Source: blog.google/innovation-and-ai/products/gemini-notebook/notebooklm-gem…

Verdict

The 'notebooklm-py' project is a tool for developers seeking to use advanced AI capabilities in their applications. Its modular architecture, extensive feature set, and support for various AI agents make it a choice for those looking to integrate AI-driven research and content generation into their projects. However, its reliance on unofficial APIs and potential rate limiting should be carefully considered.

Frequently Asked Questions

What did the documentation review verify for notebooklm-py on 2026-09-23?

The current stable version is v0.8.2, dated 2026-09-02. The official release explicitly warns about the Android backend's master-token risk and says both backends depend on unpublished APIs. The package and Chromium were not installed.

What evidence boundary applies to this notebooklm-py review?

The review environment was: Docs only. Reviewed the official README, v0.8.2 release, and Google's rename announcement. notebooklm-py behavior outside that scope still needs a local check.

Sources and review scope
This review is based on the project's public documentation. Versions, installation commands, and feature boundaries can change upstream; check the cited sources and current release before use. Sources checked on: 2026-09-23 13:55.

Reference materials: README, GitHub API, dependency files