# notebooklm-py

Unofficial Python API and agentic skill for Google NotebookLM, with CLI and agent workflow support.

## Agent Decision Summary
- Risk level: elevated
- Source confidence: medium
- Recommended workflows: Coding agent workflow, Connector or protocol layer, Reusable skill workflow
- Permission surface: shell/files, external services
- Agent JSON: https://www.openagent.bot/skills/notebooklm-py.agent.json

## Summary
notebooklm-py is an open-source unofficial Python API and agentic skill for Google NotebookLM. It provides programmatic access, CLI workflows, and integration positioning for agents such as Claude Code, Codex, and OpenClaw.


## Guide
notebooklm-py is an unofficial Python API and agentic skill for Google NotebookLM.

### What it is
It provides API and CLI access intended for agent workflows around NotebookLM.

### Why it matters
Agents need programmatic research tools, and NotebookLM-style workflows can be valuable when source material matters.

### How it works
Start from the repository, run a safe test notebook workflow, and verify compatibility with your agent host before relying on it.


### FAQ
- Is notebooklm-py open source?
  - Yes. The GitHub repository is listed under the MIT license.
- Is notebooklm-py official?
  - No. The project describes itself as an unofficial Python API and agentic skill for Google NotebookLM.
## What It Does
It provides API and CLI access intended for agent workflows around NotebookLM.

## How To Evaluate
Start from the repository, run a safe test notebook workflow, and verify compatibility with your agent host before relying on it.

## Why It Matters
NotebookLM is useful for research workflows, but many agent builders need programmatic access. notebooklm-py packages that access as an API, CLI, and agentic skill surface.


## Best For
- Researchers automating NotebookLM workflows
- Agent builders connecting NotebookLM to Claude Code, Codex, or OpenClaw
- Developers experimenting with NotebookLM APIs and podcast-style outputs

## Not For
- Teams that require only official Google-supported APIs
- Users who do not want to rely on unofficial integrations

## What It Actually Does
- NotebookLM automation: The project exposes NotebookLM workflows through Python and CLI surfaces.
  - Why it matters: Research agents often need repeatable access to source-grounded notebooks.
- Agentic skill positioning: notebooklm-py is described as an agentic skill for Claude Code, Codex, and OpenClaw.
  - Why it matters: A skill surface helps turn NotebookLM tasks into reusable agent workflows.
- Research workflow fit: Topics include NotebookLM API, podcast generator, and research-oriented usage.
  - Why it matters: NotebookLM is strongest when paired with source-heavy research and synthesis tasks.

## Typical Use Cases
- NotebookLM batch workflows: Automate repeated NotebookLM tasks through Python or CLI access.
- Agent research skills: Let coding agents trigger NotebookLM-style workflows from a reusable skill.
- Source-grounded synthesis: Experiment with source-backed summaries and audio-style research outputs.

## How It Compares
- When to choose notebooklm-py: Compare it with nearby skills by looking at hosting model, integration surface, license, and whether the official docs show the workflow you need.

## Fit Matrix
- Coding agent workflow: strong. notebooklm-py has multiple signals for coding agent workflow, including matching tags, capabilities, category, or positioning. Required check: Run a small repository change and inspect the diff, tests, and rollback path.
- Connector or protocol layer: strong. notebooklm-py has multiple signals for connector or protocol layer, including matching tags, capabilities, category, or positioning. Required check: Connect one low-risk service, then inspect schemas, auth scope, errors, and logs.
- Reusable skill workflow: strong. notebooklm-py has multiple signals for reusable skill workflow, including matching tags, capabilities, category, or positioning. Required check: Run one skill end to end and check whether it produces evidence or structured output.
- Browser automation: partial. notebooklm-py has at least one signal for browser automation, but should be checked against a real task before adoption. Required check: Run one non-sensitive website task and inspect clicks, waits, retries, and changed URLs.
- Evaluation and observability: weak. notebooklm-py is not primarily positioned for evaluation and observability in the current metadata. Required check: Add one repeatable test case and confirm results can run again in review or CI.
- Local or private AI stack: weak. notebooklm-py is not primarily positioned for local or private ai stack in the current metadata. Required check: Verify hardware requirements, data path, storage, and whether all calls stay in your environment.

## Evidence
- verified: notebooklm-py is listed as open source. Source: License metadata: MIT
- verified: notebooklm-py has a recorded GitHub repository: teng-lin/notebooklm-py. Source: Resource facts and GitHub source link.
- inferred: notebooklm-py supports these recorded deployment modes: cloud. Source: OpenAgent decision signal metadata.
- inferred: notebooklm-py is tagged with agent skill, workflow, automation capabilities. Source: OpenAgent capability taxonomy.

## Missing Checks
- Dedicated docs link is missing.
- Repository freshness has not been recorded.

## Next Actions
- Inspect repository: https://github.com/teng-lin/notebooklm-py

## Facts
- Category: skills
- Resource type: skill
- Open source: yes
- License: MIT
- Last verified: 2026-06-11
- GitHub repo: teng-lin/notebooklm-py
- GitHub stars: 16224

## Capabilities
- agent-skill
- workflow
- automation

## Structured Use Case Tags
- developer-workflow

## Getting Started
- Open the GitHub repository: https://github.com/teng-lin/notebooklm-py

## Links
- GitHub: https://github.com/teng-lin/notebooklm-py

## Structured Outputs
- JSON: https://www.openagent.bot/skills/notebooklm-py.json
- Markdown: https://www.openagent.bot/skills/notebooklm-py.md
- Agent JSON: https://www.openagent.bot/skills/notebooklm-py.agent.json
- Canonical: https://www.openagent.bot/skills/notebooklm-py
