notebooklm-skill  by PleasePrompto

NotebookLM integration skill for Claude Code

Created 2 months ago
1,381 stars

Top 29.1% on SourcePulse

GitHubView on GitHub
Project Summary

This skill enables Claude Code to directly query Google NotebookLM, delivering source-grounded, citation-backed answers exclusively from user-uploaded documents. It targets users of local Claude Code installations, aiming to eliminate manual copy-pasting between NotebookLM and their coding environment, thereby reducing hallucinations and boosting research efficiency.

How It Works

The skill acts as a Claude Code Skill, using Python scripts and browser automation (Patchright, Playwright-based) to interface with NotebookLM. When NotebookLM is referenced or a URL is provided, Python scripts handle authentication, query NotebookLM via Gemini, and return synthesized answers directly to Claude Code. This approach bypasses local RAG setup complexities, leveraging NotebookLM's pre-processed knowledge and Gemini's synthesis for strictly document-based, low-hallucination responses.

Quick Start & Requirements

  • Installation: Clone https://github.com/PleasePrompto/notebooklm-skill into ~/.claude/skills/notebooklm.
  • Prerequisites: Local Claude Code installation (required), Python 3.8+ (implied), Google Chrome (auto-installed), Google account for NotebookLM.
  • Setup Time: Approx. 5 minutes.
  • Links: Repo: https://github.com/PleasePrompto/notebooklm-skill, NotebookLM: https://notebooklm.google.com/

Highlighted Details

  • Source-grounded responses with citations, exclusively from uploaded documents.
  • Direct integration with Claude Code, eliminating manual copy-pasting.
  • Smart library management for saving and recalling NotebookLM notebooks.
  • Automated, persistent Google authentication via browser automation.
  • Self-contained with an isolated Python environment (.venv).

Maintenance & Community

Shared by its author for community use, with issues and troubleshooting directed to the GitHub repository. No dedicated community channels are specified.

Licensing & Compatibility

The README does not explicitly state a software license. Compatibility is limited to local Claude Code installations. Commercial use implications are not detailed.

Limitations & Caveats

This skill functions exclusively with local Claude Code installations due to sandbox restrictions in the web UI preventing network access for browser automation. It uses a stateless session model where each query is independent. Users must manually upload documents to NotebookLM, and notebooks must be shared publicly (link access). Subject to NotebookLM's free tier query limits. Browser automation may be detected by Google services; a dedicated Google account is recommended.

Health Check
Last Commit

1 month ago

Responsiveness

Inactive

Pull Requests (30d)
4
Issues (30d)
1
Star History
786 stars in the last 30 days

Explore Similar Projects

Feedback? Help us improve.