Back to Skills

nblm

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 through document-only responses.

29stars3forksUpdated 4/25/2026

Security Assessment

Critical Risk(0/100)

Detected risks:

Destructive Operations([references/troubleshooting.md] rm -rf, [docs/plans/2025-01-30-folder-sync-design.md] rm -rf)
Secret Exposure([AUTHENTICATION.md] TOKEN=)
Sensitive File Access([SKILL.md] .env, [references/api_reference.md] .env)
Command Injection([references/api_reference.md] subprocess.run, [references/usage_patterns.md] subprocess.run, [references/troubleshooting.md] subprocess.run)
Security Score0/100

About nblm

The nblm skill allows users to directly query their Google NotebookLM notebooks through Claude Code, providing answers that are both source-grounded and citation-backed. By integrating browser automation, library management, and persistent authentication, it significantly reduces hallucinations by restricting responses to documented sources. Users no longer need to manually handle authentication or library setup, making the skill a streamlined solution for reliable information retrieval from their NotebookLM data.

Key features of the nblm skill include comprehensive notebook and source management, seamless account handling, and a suite of content generation tools. Users can create, delete, rename, and summarize notebooks, manage multiple Google accounts, and organize sources by uploading files, folders, URLs, or media content such as YouTube videos. The skill also supports AI-powered content generation, including question answering, podcasts, briefings, debates, slide decks, and infographics, all of which can be downloaded or managed directly through command-line interactions. Advanced options like folder syncing, rebuild tracking, and upload targeting provide fine-grained control over notebook updates.

This skill is particularly useful for researchers, students, and professionals who maintain extensive NotebookLM libraries and need reliable, citation-based answers or content generation. It is ideal for those seeking to automate knowledge management and media production from their notes, enabling efficient summarization, presentation creation, and multimedia content generation without manual intervention. By combining automation with source-backed AI capabilities, nblm helps users save time while maintaining accuracy and traceability of their information.

FAQ

How do I authenticate with my Google account?

Use the `/nblm login` command. If authentication is missing or expired, a browser window will open automatically to guide you through the process.

Can I manage multiple Google accounts?

Yes, commands like `accounts add`, `accounts switch <id>`, and `accounts remove <id>` allow full account management, including setting agent-specific overrides.

What types of sources can I upload to NotebookLM?

You can upload single files, folders, URLs, YouTube videos, text snippets, or download content from Z-Library using the corresponding upload commands.

Do I need to manually install dependencies?

No, all dependencies and authentication are handled automatically on first run via `run.py`, which sets up the virtual environment and installs Python/Node.js requirements.

How can I generate content like podcasts or slides?

Use commands such as `podcast`, `slides`, `briefing`, and `infographic` along with optional instructions. Generated content can be downloaded or listed using the relevant download or media commands.

All Files

59 files
commands/nblm-accounts.md1.3 KB
View
scripts/cleanup_manager.py9.3 KB
View
scripts/nblm_cli.py12.8 KB
View
tests/test_agent_browser_state.py3.6 KB
View
tests/test_run_env.py2.7 KB
View
tests/test_wait_for_answer.py6.9 KB
View
CHANGELOG.md3.9 KB
View
commands/nblm-status.md0.4 KB
View
package-lock.json1.5 KB
View
scripts/account_manager.py16.5 KB
View
scripts/zlibrary/downloader.py6.3 KB
View
SKILL.md23.4 KB
View
scripts/init_platform.py12.0 KB
View
tests/test_notebooklm_credentials.py11.2 KB
View
tests/test_sync_manager.py17.8 KB
View
LICENSE1.0 KB
View
references/api_reference.md9.2 KB
View
requirements.txt0.4 KB
View
scripts/ask_question.py16.8 KB
View
tests/test_idle_watchdog.py4.5 KB
View
.gitignore0.8 KB
View
commands/nblm-ask.md0.5 KB
View
scripts/patchright_auth.py15.6 KB
View
scripts/source_manager.py15.7 KB
View
tests/test_zlibrary_epub_converter.py1.0 KB
View
AUTHENTICATION.md2.5 KB
View
commands/nblm-login.md0.3 KB
View
CLAUDE.md8.6 KB
View
commands/nblm-upload.md0.7 KB
View
package.json0.3 KB
View
scripts/agent_browser_client.py22.3 KB
View
scripts/config.py3.5 KB
View
scripts/run.py16.6 KB
View
README.zh-CN.md8.4 KB
View
references/usage_patterns.md9.3 KB
View
scripts/auth_manager.py43.7 KB
View
scripts/daemon_watchdog.py3.0 KB
View
tests/test_navigate_wait_until.py1.5 KB
View
AGENTS.md6.3 KB
View
README.md11.6 KB
View
references/troubleshooting.md9.1 KB
View
scripts/artifact_manager.py16.0 KB
View
scripts/setup_environment.py7.7 KB
View
tests/test_agent_browser_client.py4.3 KB
View
tests/test_auth_manager_services.py5.1 KB
View
commands/nblm-activate.md0.4 KB
View
scripts/notebook_manager.py22.4 KB
View
tests/test_source_manager.py4.1 KB
View
tests/test_watchdog_status.py1.7 KB
View
commands/nblm-add.md0.7 KB
View
scripts/notebooklm_wrapper.py36.3 KB
View
tests/test_zlibrary_downloader.py6.9 KB
View
commands/nblm-list.md0.3 KB
View
scripts/zlibrary/__init__.py0.0 KB
View
docs/plans/2025-01-30-folder-sync-design.md32.8 KB
View
scripts/__init__.py2.7 KB
View
scripts/sync_manager.py17.0 KB
View
scripts/zlibrary/epub_converter.py6.0 KB
View
tests/test_ask_question_fallback.py2.1 KB
View

Install nblm

Download and extract the skill files to your .claude/skills/ directory.

Quick Setup:

  1. Copy the skill folder to .claude/skills/
  2. Claude will automatically detect and use the skill

Repository

magicseek/nblm