notebooklm-py provides an unofficial Python API and command-line interface (CLI) for Google NotebookLM, enabling programmatic automation of research workflows, content generation, and AI agent integration. It targets researchers, developers, and power users seeking to leverage NotebookLM's capabilities beyond its web interface, facilitating repeatable research pipelines and automated content creation from diverse sources.

How It Works

This library interfaces with NotebookLM via undocumented Google APIs, providing a flexible architecture accessible through a Python API, a CLI, and specialized Agent Skills for platforms like Claude Code. Its advantage lies in enabling automation and custom integrations where official APIs are unavailable. The approach supports asynchronous workflows and integrates with various LLM agent frameworks.

Quick Start & Requirements

• Installation: pip install notebooklm-py or pip install "notebooklm-py[browser]" for browser login.
• Prerequisites: playwright install chromium is required for initial browser-based authentication.
• Setup: Requires an initial browser-based login (notebooklm login).
• Documentation: CLI Reference, Python API, Configuration, Troubleshooting available.

Highlighted Details

• Supports diverse source ingestion: URLs, PDFs, YouTube, Google Drive, and text.
• Enables programmatic content generation: audio podcasts, videos, slides, quizzes, flashcards, reports, infographics, and mind maps.
• Facilitates research automation via web and Drive agents with auto-import capabilities.
• Offers AI agent integration, including Claude Code skills for natural language automation.

Maintenance & Community

This is a community project hosted on GitHub (https://github.com/teng-lin/notebooklm-py). Specific details on active contributors, community channels (like Discord/Slack), or a public roadmap are not detailed in the README.

Licensing & Compatibility

Licensed under the MIT License. While permissive for commercial use, its unofficial nature and reliance on undocumented APIs present significant adoption risks.

Limitations & Caveats

This is an unofficial library utilizing undocumented Google APIs, subject to change or breakage without notice. Users should proceed with caution ("Use at Your Own Risk"), as API stability is not guaranteed, and heavy usage may incur rate limits. It is best suited for prototypes, research, and personal projects rather than mission-critical production systems.