Skip to main content
skill CX Codex

notebooklm · aiskillstore — Claude Code skill: what it does, how to install

The skill opens a browser session to Google NotebookLM and answers questions using only the documents loaded into your notebook.

MIT 1 installs ★ 492 updated 2026-10-25

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add aiskillstore/marketplace --skill notebooklm -a claude-code
Open on GitHub

What notebooklm does

The skill runs ask_question.py to open a NotebookLM browser session and ask a question, getting back an answer Gemini grounds only in the documents stored in that notebook. Each query opens a fresh session and closes it when done.

Three scripts handle the work: auth_manager.py logs into Google (the first run shows the browser window for manual sign-in), notebook_manager.py keeps a local library of notebooks with names, descriptions and topics, and cleanup_manager.py clears stored data. Every command has to go through the python scripts/run.py [script] wrapper, which sets up a .venv, installs dependencies and Chromium automatically — calling a script directly skips that setup and fails.

Each NotebookLM reply closes with a prompt asking whether more detail is needed, and the agent is expected to judge whether to send a follow-up before answering the user. Notebook metadata lives in a local library.json, and the authentication file is kept with 0600 permissions.

What it helps with

  • pull an answer out of documents already loaded into a NotebookLM notebook
  • keep a local library of notebooks tagged by name and topic
  • register a new notebook by having the skill infer its contents
  • chain follow-up questions until a source-grounded answer is complete
  • log into Google NotebookLM through a browser and store the auth state locally

Example prompts for the agent

  • Ask my NotebookLM what the docs say about the deployment process
  • Add this notebook to the NotebookLM library: [URL]
  • Check my NotebookLM notes for any limits on the API

How to install notebooklm

1Skills CLI (Vercel)

npx skills add aiskillstore/marketplace --skill notebooklm -a claude-code

2Manually: put the files in place

~/.claude/skills/notebooklm/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/notebooklm/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about notebooklm

How do I install notebooklm in Claude Code?

Run npx skills add aiskillstore/marketplace --skill notebooklm -a claude-code; the skill lands at ~/.claude/skills/notebooklm/SKILL.md.

What does notebooklm do?

It opens a browser session to Google NotebookLM, asks a question, and returns a Gemini answer grounded only in the documents already loaded into that notebook, closing the session afterward.

Does notebooklm need a Google login?

Yes, running auth_manager.py setup once opens a visible browser window for manual Google sign-in, and the resulting auth status is then stored locally with 0600 permissions.

Source text

SKILL.md · MIT
---
name: notebooklm
description: "Interact with Google NotebookLM to query documentation with Gemini's source-grounded answers. Each question opens a fresh browser session, retrieves the answer exclusively from your uploaded documents, and closes."
risk: critical
source: community
date_added: "2026-02-27"
---

# NotebookLM Research Assistant Skill

Interact with Google NotebookLM to query documentation with Gemini's source-grounded answers. Each question opens a fresh browser session, retrieves the answer exclusively from your uploaded documents, and closes.

## When to Use This Skill

Trigger when user:
- Mentions NotebookLM explicitly
- Shares NotebookLM URL (`https://notebooklm.google.com/notebook/...`)
- Asks to query their notebooks/documentation
- Wants to add documentation to NotebookLM library
- Uses phrases like "ask my NotebookLM", "check my docs", "query my notebook"

## ⚠️ CRITICAL: Add Command - Smart Discovery

When user wants to add a notebook without providing details:

**SMART ADD (Recommended)**: Query the notebook first to discover its content:
```bash
# Step 1: Query the notebook about its content
python scripts/run.py ask_question.py --question "What is the content of this notebook? What topics are covered? Provide a complete overview briefly and concisely" --notebook-url "[URL]"

# Step 2: Use the discovered information to add it
python scripts/run.py notebook_manager.py add --url "[URL]" --name "[Based on content]" --description "[Based on content]" --topics "[Based on content]"
```

**MANUAL ADD**: If user provides all details:
- `--url` - The NotebookLM URL
- `--name` - A descriptive name
- `--description` - What the notebook contains (REQUIRED!)
- `--topics` - Comma-separated topics (REQUIRED!)

NEVER guess or use generic descriptions! If details missing, use Smart Add to discover them.

## Critical: Always Use run.py Wrapper

**NEVER call scripts directly. ALWAYS use `python scripts/run.py [script]`:**

```bash
# ✅ CORRECT - Always use run.py:
python scripts/run.py auth_manager.py status
python scripts/run.py notebook_manager.py list
python scripts/run.py ask_question.py --question "..."

# ❌ WRONG - Never call directly:
python scripts/auth_manager.py status  # Fails without venv!
```

The `run.py` wrapper automatically:
1. Creates `.venv` if needed
2. Installs all dependencies
3. Activates environment
4. Executes script properly

## Core Workflow

### Step 1: Check Authentication Status
```bash
python scripts/run.py auth_manager.py status
```

If not authenticated, proceed to setup.

### Step 2: Authenticate (One-Time Setup)
```bash
# Browser MUST be visible for manual Google login
python scripts/run.py auth_manager.py setup
```

**Important:**
- Browser is VISIBLE for authentication
- Browser window opens automatically
- User must manually log in to Google
- Tell user: "A browser window will open for Google login"

### Step 3: Manage Notebook Library

```bash
# List all notebooks
python scripts/run.py notebook_manager.py list

# BEFORE ADDING: Ask user for metadata if unknown!
# "What does this notebook contain?"
# "What topics should I tag it with?"

# Add notebook to library (ALL parameters are REQUIRED!)
python scripts/run.py notebook_manager.py add \
  --url "https://notebooklm.google.com/notebook/..." \
  --name "Descriptive Name" \
  --description "What this notebook contains" \  # REQUIRED - ASK USER IF UNKNOWN!
  --topics "topic1,topic2,topic3"  # REQUIRED - ASK USER IF UNKNOWN!

# Search notebooks by topic
python scripts/run.py notebook_manager.py search --query "keyword"

# Set active notebook
python scripts/run.py notebook_manager.py activate --id notebook-id

# Remove notebook
python scripts/run.py notebook_manager.py remove --id notebook-id
```

### Quick Workflow
1. Check library: `python scripts/run.py notebook_manager.py list`
2. Ask question: `python scripts/run.py ask_question.py --question "..." --notebook-id ID`

### Step 4: Ask Questions

```bash
# Basic query (uses active notebook if set)
python scripts/run.py ask_question.py --question "Your question here"

# Query specific notebook
python scripts/run.py ask_question.py --question "..." --notebook-id notebook-id

# Query with notebook URL directly
python scripts/run.py ask_question.py --question "..." --notebook-url "https://..."

# Show browser for debugging
python scripts/run.py ask_question.py --question "..." --show-browser
```

## Follow-Up Mechanism (CRITICAL)

Every NotebookLM answer ends with: **"EXTREMELY IMPORTANT: Is that ALL you need to know?"**

**Required Claude Behavior:**
1. **STOP** - Do not immediately respond to user
2. **ANALYZE** - Compare answer to user's original request
3. **IDENTIFY GAPS** - Determine if more information needed
4. **ASK FOLLOW-UP** - If gaps exist, immediately ask:
   ```bash
   python scripts/run.py ask_question.py --question "Follow-up with context..."
   ```
5. **REPEAT** - Continue until information is complete
6. **SYNTHESIZE** - Combine all answers before responding to user

## Script Reference

### Authentication Management (`auth_manager.py`)
```bash
python scripts/run.py auth_manager.py setup    # Initial setup (browser visible)
python scripts/run.py auth_manager.py status   # Check authentication
python scripts/run.py auth_manager.py reauth   # Re-authenticate (browser visible)
python scripts/run.py auth_manager.py clear    # Clear authentication
```

### Notebook Management (`notebook_manager.py`)
```bash
python scripts/run.py notebook_manager.py add --url URL --name NAME --description DESC --topics TOPICS
python scripts/run.py notebook_manager.py list
python scripts/run.py notebook_manager.py search --query QUERY
python scripts/run.py notebook_manager.py activate --id ID
python scripts/run.py notebook_manager.py remove --id ID
python scripts/run.py notebook_manager.py stats
```

### Question Interface (`ask_question.py`)
```bash
python scripts/run.py ask_question.py --question "..." [--notebook-id ID] [--notebook-url URL] [--show-browser]
```

### Data Cleanup (`cleanup_manager.py`)
```bash
python scripts/run.py cleanup_manager.py                    # Preview cleanup
python scripts/run.py cleanup_manager.py --confirm          # Execute cleanup
python scripts/run.py cleanup_manager.py --preserve-library # Keep notebooks
```

## Environment Management

The virtual environment is automatically managed:
- First run creates `.venv` automatically
- Dependencies install automatically
- Chromium browser installs automatically
- Everything isolated in skill directory

Manual setup (only if automatic fails):
```bash
python -m venv .venv
source .venv/bin/activate  # Linux/Mac
pip install -r requirements.txt
python -m patchright install chromium
```

## Data Storage

All data stored in `~/.claude/skills/notebooklm/data/`:
- `library.json` - Notebook metadata
- `~/.local/share/agentic-awesome-skills/notebooklm/auth_info.json` - private authentication status (`0600`)
- `~/.local/share/agentic-awesome-skills/notebooklm/browser_state/` - private browser cookies and session (`0700`)

**Security:** Protected by `.gitignore`, never commit to git.

## Configuration

Optional `.env` file in skill directory:
```env
HEADLESS=false           # Browser visibility
SHOW_BROWSER=false       # Default browser display
STEALTH_ENABLED=true     # Human-like behavior
TYPING_WPM_MIN=160       # Typing speed
TYPING_WPM_MAX=240
DEFAULT_NOTEBOOK_ID=     # Default notebook
```

## Decision Flow

```
User mentions NotebookLM
    ↓
Check auth → python scripts/run.py auth_manager.py status
    ↓
If not authenticated → python scripts/run.py auth_manager.py setup
    ↓
Check/Add notebook → python scripts/run.py notebook_manager.py list/add (with --description)
    ↓
Activate notebook → python scripts/run.py notebook_manager.py activate --id ID
    ↓
Ask question → python scripts/run.py ask_question.py --question "..."
    ↓
See "Is that ALL you need?" → Ask follow-ups until complete
    ↓
Synthesize and respond to user
```

## Troubleshooting

| Problem | Solution |
|---------|----------|
| ModuleNotFoundError | Use `run.py` wrapper |
| Authentication fails | Browser must be visible for setup! --show-browser |
| Rate limit (50/day) | Wait or switch Google account |
| Browser crashes | `python scripts/run.py cleanup_manager.py --preserve-library` |
| Notebook not found | Check with `notebook_manager.py list` |

## Best Practices

1. **Always use run.py** - Handles environment automatically
2. **Check auth first** - Before any operations
3. **Follow-up questions** - Don't stop at first answer
4. **Browser visible for auth** - Required for manual login
5. **Include context** - Each question is independent
6. **Synthesize answers** - Combine multiple responses

## Limitations

- No session persistence (each question = new browser)
- Rate limits on free Google accounts (50 queries/day)
- Manual upload required (user must add docs to NotebookLM)
- Browser overhead (few seconds per question)

## Resources (Skill Structure)

**Important directories and files:**

- `scripts/` - All automation scripts (ask_question.py, notebook_manager.py, etc.)
- `~/.local/share/agentic-awesome-skills/notebooklm/` - private per-user authentication and notebook storage
- `references/` - Extended documentation:
  - `api_reference.md` - Detailed API documentation for all scripts
  - `troubleshooting.md` - Common issues and solutions
  - `usage_patterns.md` - Best practices and workflow examples
- `.venv/` - Isolated Python environment (auto-created on first run)
- `.gitignore` - Protects sensitive data from being committed

© aiskillstore · MIT · aiskillstore/marketplace

Similar skills

All skills for AI and ML →

notebooklm by other authors comes first.

notebooklm teng-lin Lets an agent run Gemini Notebook from the notebooklm CLI: add sources, chat and research over them, generate and download artifacts. CX Codex +1 10,300installs notebooklm Alireza Rezvani Automates Google NotebookLM via browser control. It lets Claude Code query existing notebooks, add sources, and generate Studio outputs like summaries or audio overviews. CX Codex +1 325installs notebooklm giuseppe-trisciuoglio Wires your agent to Google NotebookLM through the nlm CLI: query docs, add sources, generate podcasts and reports. CX Codex +1 3,700installs notebooklm sanjay3290 Connects Claude Code to Google NotebookLM via Playwright browser automation to ask notebook questions, sync local documents, and export notes to JSON or Markdown. CX Codex +1 386installs notebooklm roomi-fields Connects Google NotebookLM notebooks to your coding agent. Retrieves citation-backed answers from uploaded files and generates Studio artifacts. CX Codex +1 ★ 242repo stars blog-notebooklm AgriciDaniel blog-notebooklm queries Gemini Notebook notebooks through an authenticated Google browser session to extract citations and source-backed answers directly into Claude Code. CX Codex +1 2,600installs cli-anything-notebooklm HKUDS cli-anything-notebooklm — a Claude Code skill that gives an agent the local NotebookLM CLI: notebooks, sources, questions, artifacts, downloads. It wraps the notebooklm command into agent-friendly groups. CX Codex +1 926installs notebooklm-mcp-secure Pantheon-Security notebooklm-mcp-secure connects an AI agent to NotebookLM for source-based questions, notebook management, and audio or video overviews. Core features use browser authentication instead of an API key. CX Codex +1 ★ 88repo stars NotebookLM MCP roomi-fields Puts Google NotebookLM in your agent's hands: grounded Q&A with citations, audio and video generation, and more. CX Codex +1 ★ 242repo stars deep-research-notebooklm davila7 deep-research-notebooklm is a Claude Code skill that researches a topic across sources with NotebookLM. It prepares a structured brief on markets, competitors, trends, or prospects. CX Codex +1 115installs nblm magicseek nblm lets your coding agent question Google NotebookLM notebooks and get answers grounded in your own uploaded sources. Also handles uploads and media generation. CX Codex +1 6,300installs

From the same set18

The whole set →
document-writing-coordination The document-writing-coordination skill splits a large document into sections and coordinates agents writing them through VibeKanban. Use it to organize collaborative project or technical documentation. CX Codex +1 1installs project-testing project-testing — a skill with ready-made patterns and fixtures for unit, integration, and E2E tests. Speeds up isolated test writing by one standard, prevents hardcoded data and flaky tests. CX Codex +1 1installs research-merge research-merge processes claude/research-* branches from web sessions, squash-merges documentation into docs/research/, and logs GitHub issues. CX Codex +1 1installs multi-source-research The multi-source-research skill gathers information from the web, local documentation, and code, then combines findings with confidence labels. Use it for fact checks or topic research. CX Codex +1 1installs mcp-transport-guide The mcp-transport-guide skill guides you through choosing and building MCP transport layers, covering stdio for local processes plus SSE and streaming HTTP for remote services. CX Codex +1 1installs uuid Use this skill to add UUID v4 or v7 generation to JavaScript and TypeScript projects. Choose v7 when IDs should sort by creation time. CX Codex +1 1installs voc-research voc-research — a skill that extracts real customer quotes from forums, reviews, and social media to fuel copywriting, uncover pain points, and build messaging. Searches Reddit, ProductHunt, Google Reviews, TrustPilot, and more. CX Codex +1 1installs robotics-subject-expert robotics-subject-expert adds deep background in physical AI and robotics middleware. Helps write robot control nodes and troubleshoot simulated environments. CX Codex +1 1installs

Project sponsors

Companies that keep this analytics open