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...

View on GitHub ↗Jump to charts ↓Open shareable report

Summary Information

Updated 48 minutes ago
Added to GitGenius on March 13th, 2026
Created on January 7th, 2026
Open Issues & Pull Requests: 34 (+0)
GitHub issues: Enabled
Number of forks: 2,581
Total Stargazers: 19,273 (+0)
Total Subscribers: 91 (+0)

Repository Insights (GitGenius)

Median issue/PR response: 3.7 hours
Mean response time: 43.4 hours
90th percentile: 5.0 days
Tracked items: 660

How this project is maintained

Around half of the issues opened in the past year never receive a reply. 31% of open issues come from outside the core team, a mix of external reports and the maintainers' own roadmap. Only 15% of issues opened in the past year have been closed. Three people close 99% of everything that gets resolved.

Charts & Analytics

Fetching additional details & charts...

Issue Activity (beta)

Open issues: 39
New in 7 days: 21
Closed in 7 days: 13
Avg open age: 12 days
Stale 30+ days: 24
Stale 90+ days: 4

Recent activity

Opened in 7 days: 20
Closed in 7 days: 13
Comments in 7 days: 11
Events in 7 days: 42

Top labels

  • bug (212)
  • enhancement (129)
  • automated (49)
  • bot-generated (48)
  • ready-for-agent (48)
  • P2 (39)
  • rpc-error (29)
  • P1 (27)

Detailed Description

notebooklm-py is an unofficial Python API and agentic skill for Google Gemini Notebook that provides full programmatic access to NotebookLM's features, including capabilities not exposed in the web UI, via Python, CLI, and AI agents like Claude Code and Codex.

The tool solves the problem of integrating NotebookLM into automated workflows and agent systems. It works by exposing undocumented Google APIs through a Python interface, allowing developers to programmatically control research automation, content generation, and artifact export. This enables use cases like bulk-importing sources, generating audio overviews and study materials, downloading artifacts in multiple formats, and orchestrating NotebookLM as a synthesis layer within larger agent workflows.

Adoption requires understanding that this is an unofficial library using undocumented APIs that Google can change without notice. It suits prototypes, research projects, and personal automation rather than production systems dependent on API stability. The library is best used as a zero-token synthesis and memory layer that agents drive in a loop, offloading expensive analysis to NotebookLM while the agent handles orchestration and final output formatting. The tool distinguishes itself by exposing features the web UI doesn't offer, such as batch downloads, quiz and flashcard export in multiple formats, and mind map JSON extraction.

The project's issue tracker is maintained primarily by its own members, reading more as internal planning than inbound user demand. Maintainers respond to new issues and pull requests within hours. Work in the tracker centers on bug fixes, enhancements, and items labeled ready-for-agent.