pleaseprompto/notebooklm-skill

Use this skill to enable Claude Code to communicate directly with your Google NotebookLM notebooks. Query your uploaded documents and get source-grounded, citation-backed answers from Gemini. Features browser automation, library management, persistent authentication, and answers exclusively from your own knowledge base.

2.7K stars255 forksUpdated Nov 21, 2025
npx skills add pleaseprompto/notebooklm-skill

README

NotebookLM Claude Code Skill

Let Claude Code chat directly with NotebookLM for source-grounded answers based exclusively on your uploaded documents

Python Claude Code Skill Based on GitHub

Use this skill to query your Google NotebookLM notebooks directly from Claude Code for source-grounded, citation-backed answers from Gemini. Browser automation, library management, persistent auth. Drastically reduced hallucinations - answers only from your uploaded documents.

InstallationQuick StartWhy NotebookLMHow It WorksMCP Alternative


⚠️ Important: Local Claude Code Only

This skill works ONLY with local Claude Code installations, NOT in the web UI.

The web UI runs skills in a sandbox without network access, which this skill requires for browser automation. You must use Claude Code locally on your machine.


The Problem

When you tell Claude Code to "search through my local documentation", here's what happens:

  • Massive token consumption: Searching through documentation means reading multiple files repeatedly
  • Inaccurate retrieval: Searches for keywords, misses context and connections between docs
  • Hallucinations: When it can't find something, it invents plausible-sounding APIs
  • Manual copy-paste: Switching between NotebookLM browser and your editor constantly

The Solution

This Claude Code Skill lets Claude Code chat directly with NotebookLM — Google's source-grounded knowledge base powered by Gemini 2.5 that provides intelligent, synthesized answers exclusively from your uploaded documents.

Your Task → Claude asks NotebookLM → Gemini synthesizes answer → Claude writes correct code

No more copy-paste dance: Claude asks questions directly and gets answers straight back in the CLI. It builds deep understanding through automatic follow-ups, getting specific implementation details, edge cases, and best practices.


Why NotebookLM, Not Local RAG?

ApproachToken CostSetup TimeHallucinationsAnswer Quality
Feed docs to Claude🔴 Very high (multiple file reads)InstantYes - fills gapsVariable retrieval
Web search🟡 MediumInstantHigh - unreliable sourcesHit or miss
Local RAG🟡 Medium-HighHours (embeddings, chunking)Medium - retrieval gapsDepends on setup
NotebookLM Skill🟢 Minimal5 minutesMinimal - source-grounded onlyExpert synthesis

What Makes NotebookLM Superior?

  1. Pre-processed by Gemini: Upload docs once, get instant expert knowledge
  2. Natural language Q&A: Not just retrieval — actual understanding and synthesis
  3. Multi-source correlation: Connects information across 50+ documents
  4. Citation-backed: Every answer includes source references
  5. No infrastructure: No vector DBs, embeddings, or chunking strategies needed

Installation

The simplest installation ever:

# 1. Create skills directory (if it doesn't exist)
mkdir -p ~/.claude/skills

# 2. Clone this repository
cd ~/.claude/skills
git clone https://github.com/PleasePrompto/notebooklm-skill notebooklm

# 3. That's it! Open Claude Code and say:
"What are my skills?"

When you first use the skill, it automatically:

  • Creates an isolated Python environment (.venv)
  • Installs all dependencies including Google Chrome
  • Sets up browser automation with Chrome (not Chromium) for maximum reliability
  • Everything stays contained in the skill folder

Note: The setup uses real Chrome instead of Chromium for cross-platform reliability, consistent browser fingerprinting, and better anti-detection with Google services


Quick Start

1. Check your skills

Say in Claude Code:

"What skills do I have?"

Claude will list your available skills including NotebookLM.

2. Authenticate with Google (one-time)

"Set up NotebookLM authentication"

A Chrome window opens → log in with your Google account

3. Create your knowledge base

Go to [notebooklm.google.com](https://notebooklm.goo

...

Read full README

Publisher

pleasepromptopleaseprompto

Statistics

Stars2.7K
Forks255
Open Issues10
LicenseMIT License
CreatedOct 19, 2025