---
description: Programmatic control over NotebookLM notebooks, sources, and artifacts
---

# NotebookLM Automation

Complete programmatic control over NotebookLM notebooks, sources, and artifacts.

## Prerequisites

```bash
pip install notebooklm-py
playwright install chromium
notebooklm login
```

## Commands

### Notebooks
```bash
notebooklm list [--json]
notebooklm create "Title" [--json]
notebooklm rename <id> "New Name"
notebooklm delete <id>
notebooklm use <id>
```

### Sources
```bash
notebooklm source add "https://..." [--json]
notebooklm source add ./file.pdf
notebooklm source list [--json]
notebooklm source delete <id>
notebooklm source wait <id>
```

### Artifacts
```bash
notebooklm artifact list [--json]
notebooklm artifact wait <id>
notebooklm artifact delete <id>
```

## Environment Variables

| Variable | Purpose |
|----------|---------|
| `NOTEBOOKLM_HOME` | Custom config dir |
| `NOTEBOOKLM_AUTH_JSON` | Inline auth (CI/CD) |

## Autonomy

**Auto-run:** `list`, `status`, `create`, `use`, `source add`
**Ask first:** `delete`, `rename`

## Source
Full details: `/Users/ourdigital/Projects/our-claude-skills/custom-skills/51-notebooklm-automation/code/CLAUDE.md`