---
description: Q&A agent using NotebookLM's Gemini-powered analysis with source citations
---

# NotebookLM Agent

Q&A agent that answers questions using NotebookLM's Gemini-powered analysis with source citations.

## Prerequisites

```bash
pip install notebooklm-py
playwright install chromium
notebooklm login  # One-time auth
```

## Commands

```bash
# List notebooks
notebooklm list

# Set context
notebooklm use <notebook_id>

# Ask questions
notebooklm ask "What are the key findings?"
notebooklm ask "Elaborate on point 2"  # continues conversation
notebooklm ask "New topic" --new       # new conversation

# With citations (JSON output)
notebooklm ask "Summarize" --json

# Query specific sources
notebooklm ask "Compare" -s source1 -s source2
```

## Autonomy

**Auto-run:** `list`, `status`, `source list`, `ask`
**Ask first:** `delete`, `source add`

## JSON Output Format

```json
{
  "answer": "Response with [1] [2] citations",
  "references": [
    {"source_id": "...", "citation_number": 1, "cited_text": "..."}
  ]
}
```

## Error Recovery

| Error | Fix |
|-------|-----|
| No context | `notebooklm use <id>` |
| Auth error | `notebooklm login` |

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