Bring the full Google NotebookLM experience to Claude Code. Chat with your notebook AI, generate 9 types of artifacts, manage sources (URLs, YouTube, files), run fast/deep web research, and manage notes — just ask Claude.
Use npx skills to install skills directly:
# Install the skill
npx skills add proyecto26/notebooklm-ai-plugin
# List available skills
npx skills add proyecto26/notebooklm-ai-plugin --listThis automatically installs to your .claude/skills/ directory.
Install via Claude Code's built-in plugin system:
# Add the marketplace
/plugin marketplace add proyecto26/notebooklm-ai-plugin
# Install the plugin
/plugin install notebooklm-ai-pluginClone the repo and copy the skills folder:
git clone https://github.com/proyecto26/notebooklm-ai-plugin.git
cp -r notebooklm-ai-plugin/skills/* .claude/skills/Add as a submodule for easy updates:
git submodule add https://github.com/proyecto26/notebooklm-ai-plugin.git .claude/notebooklm-ai-pluginThen reference skills from .claude/notebooklm-ai-plugin/skills/.
- Fork this repository
- Customize the skill for your specific needs
- Clone your fork into your projects
The first time you use the skill, it opens Chrome for Google login. Cookies are cached for subsequent runs. Just tell Claude:
"Log me into NotebookLM"
Once authenticated, just describe what you want:
"Add this notebook https://notebooklm.google.com/notebook/YOUR_ID and generate a study guide from it"
That's it — the skill handles everything: authentication, notebook management, artifact creation, polling, and download.
Ask questions and get source-grounded answers with citations — the same AI chat experience from NotebookLM's web UI, now in your terminal.
| Type | Output | Description |
|---|---|---|
| Slide Deck | PDF / PPTX | Presentation slides summarizing your notebook sources |
| Audio Overview | M4A | Podcast-style conversation (deep dive, brief, critique, debate) |
| Video Overview | MP4 | Animated explainer (classic, whiteboard, kawaii, anime, watercolor) |
| Mind Map | HTML | Interactive concept map of key topics and relationships |
| Flashcards | HTML / JSON | Study cards generated from source material |
| Quiz | HTML / JSON | Multiple-choice quiz with answer key and explanations |
| Infographic | PNG | Visual summary in landscape, portrait, or square orientation |
| Report | Markdown | Written report (briefing doc, study guide, blog post) |
| Data Table | CSV / Sheets | Structured data extracted from your sources |
Add and manage notebook sources directly from Claude Code — no need to switch to the browser.
- URLs / Websites — Add any web page as a source
- YouTube — Add video transcripts as sources
- File Upload — PDF, TXT, MD, DOCX, CSV, EPUB, images, audio, video
- Pasted Text — Add text content with a custom title
- List / Delete — View and manage existing sources
Run web research that feeds directly into your notebook:
- Fast Research — Quick web search, finds relevant sources in seconds
- Deep Research — Comprehensive analysis with a full markdown report
- Auto-Import — Automatically add discovered sources to your notebook
Create, update, and delete notes within your notebooks programmatically.
Just describe what you need to Claude — the skill triggers automatically:
"What are the main findings in my NotebookLM notebook?"
Chats with the notebook AI and returns source-grounded answers with citations.
"Add this YouTube video to my notebook: https://youtube.com/watch?v=..."
Adds the video transcript as a source to your active notebook.
"Upload my research paper paper.pdf to the notebook and generate a study guide"
Uploads the file, then generates a markdown report in study guide format.
"Run a deep research on 'AI agent frameworks 2026' and import the results"
Starts deep web research, waits for completion, and imports sources into the notebook.
"Generate a slide deck from my NotebookLM notebook about machine learning"
Creates a PDF/PPTX presentation from your notebook sources.
"Create a deep dive audio overview of my research papers"
Generates a long-form podcast-style M4A audio discussion.
"Make a portrait infographic highlighting the key findings"
Produces a PNG infographic in portrait orientation.
"Create a note called 'Key Takeaways' with a summary of the main points"
Creates a new note in the notebook with the specified content.
| Variable | Description |
|---|---|
NOTEBOOKLM_DATA_DIR |
Override data directory |
NOTEBOOKLM_COOKIE_PATH |
Custom cookie file path |
NOTEBOOKLM_CHROME_PROFILE_DIR |
Chrome profile directory |
NOTEBOOKLM_CHROME_PATH |
Chrome executable path |
NOTEBOOKLM_OUTPUT_DIR |
Default output directory |
NotebookLM free tier limits:
| Resource | Limit |
|---|---|
| Audio / Video overviews | 3 per day |
| Reports / Flashcards / Quizzes | 10 per day |
| Daily chats | 50 |
| Total notebooks | 100 |
| Sources per notebook | 50 |
notebooklm-ai-plugin/
├── .claude-plugin/
│ ├── plugin.json # Plugin manifest
│ └── marketplace.json # Marketplace metadata
├── skills/
│ └── notebooklm/
│ ├── SKILL.md # Skill definition (triggers + docs)
│ └── scripts/
│ ├── main.ts # CLI entry point (all commands)
│ ├── auth.ts # Chrome CDP authentication
│ ├── chat.ts # Streaming chat with notebook AI
│ ├── rpc-client.ts # batchexecute protocol client
│ ├── rpc-types.ts # RPC method IDs + enum codes
│ ├── artifact-generator.ts # Create / poll / download artifacts
│ ├── source-manager.ts # Add / list / delete sources
│ ├── research-manager.ts # Fast / deep web research
│ ├── notes-manager.ts # Notes CRUD
│ ├── notebook-manager.ts # Notebook library CRUD
│ ├── cookie-store.ts # Cookie persistence
│ ├── paths.ts # Platform-aware storage
│ ├── types.ts # Shared TypeScript types
│ └── get-cookie.ts # Quick login helper
├── LICENSE
└── README.md
For full CLI commands and script usage details, see
skills/notebooklm/SKILL.md.
graph TB
subgraph "Claude Code"
A["User Prompt"] --> B["NotebookLM Skill"]
end
subgraph "Authentication"
B --> C["Chrome CDP"]
C --> D["Cookie Extraction"]
D --> E["Cookie Store"]
end
subgraph "NotebookLM API"
E --> F["batchexecute RPC"]
E --> F2["Streaming Chat"]
F --> G["Artifacts"]
F --> H["Sources"]
F --> I["Research"]
F --> I2["Notes"]
F --> I3["Notebooks"]
end
subgraph "Capabilities"
F2 --> S["AI Chat with Citations"]
G --> J["Slides / Audio / Video"]
G --> K["Quiz / Flashcards"]
G --> L["Infographic / Report"]
H --> M["URL / YouTube / File / Text"]
I --> N["Fast & Deep Web Research"]
end
style A fill:#7c3aed,color:#fff
style F fill:#1a73e8,color:#fff
style F2 fill:#1a73e8,color:#fff
style S fill:#34a853,color:#fff
style J fill:#34a853,color:#fff
style K fill:#34a853,color:#fff
style L fill:#34a853,color:#fff
style M fill:#ea4335,color:#fff
style N fill:#fbbc04,color:#000
Hybrid approach: Chrome DevTools Protocol (CDP) handles Google authentication once, then all operations use direct batchexecute RPC calls — no browser overhead for artifact generation.
sequenceDiagram
participant U as User
participant C as Claude Code
participant P as Plugin (Bun/TS)
participant Ch as Chrome (CDP)
participant N as NotebookLM API
U->>C: "Generate a slide deck from my notebook"
C->>P: Invoke notebooklm skill
Note over P,Ch: First-time auth only
P->>Ch: Launch Chrome via CDP
Ch-->>P: Google session cookies
P->>P: Cache cookies to disk
P->>N: LIST_NOTEBOOKS (batchexecute RPC)
N-->>P: Notebook sources
P->>N: CREATE_ARTIFACT (type=slide_deck)
N-->>P: Artifact ID
loop Poll every 5s
P->>N: LIST_ARTIFACTS
N-->>P: Status: processing / completed
end
P->>N: Download artifact
N-->>P: PDF/PNG/M4A/MP4 file
P-->>C: File saved to disk
C-->>U: "Slide deck saved to slides.pdf"
The plugin communicates with NotebookLM via Google's internal batchexecute protocol — the same system used across Google web apps. Each operation maps to an obfuscated RPC method ID:
| Operation | RPC ID |
|---|---|
| List Notebooks | wXbhsf |
| Create Artifact | R7cb6c |
| List Artifacts | gArtLc |
| Generate Mind Map | yyryJe |
| Get Interactive HTML | v9rmvd |
All 9 artifact types (except Mind Map) use the unified CREATE_ARTIFACT RPC with different type codes. The plugin handles response parsing, error detection, and the anti-XSSI response format automatically.
Cookies are stored in a platform-aware location:
| Platform | Path |
|---|---|
| Windows | %APPDATA%/notebooklm-ai/cookies.json |
| macOS | ~/Library/Application Support/notebooklm-ai/cookies.json |
| Linux | ~/.local/share/notebooklm-ai/cookies.json |
The plugin captures all Google domain cookies (30+) via Chrome DevTools Protocol — this is required because Google's passive login check validates cookies beyond the standard auth set.
- Audio / Video / Slides download: These streaming media types are created successfully on NotebookLM's servers, but auto-download requires browser-level cookie handling. The plugin returns the artifact URL for manual browser download. Static media (infographics, reports) download automatically.
- Data Table: Parameter structure for type 9 artifacts is still being reverse-engineered.
- RPC method IDs: Google can change these at any time. If generation fails, check for updated IDs in the notebooklm-sdk project.
This project is free and open source. Sponsors help keep it maintained and growing.
Become a Sponsor | Sponsorship Program
When contributing to this repository, please first discuss the change you wish to make via issue, email, or any other method with the owners of this repository before making a change.
Contributions are what make the open-source community such an amazing place to learn, inspire, and create. Any contributions you make are greatly appreciated ❤️.
You can learn more about how you can contribute to this project in the contribution guide.
This repository is available under the MIT License.
- notebooklm-sdk — TypeScript SDK reference for batchexecute protocol
- notebooklm-kit — Artifact creation patterns
- notebooklm-py — Python RPC reference implementation
- sherlock-ai-plugin — CDP authentication patterns
Made with ❤️ by Proyecto 26 - Changing the world with small contributions.
One hand can accomplish great things, but many can take you into space and beyond! 🌌
Together we do more, together we are more ❤️
