Content
# NotebookLM-CLI One-Click Kit
> A one-click toolkit for Google **NotebookLM** (an AI note-taking service that reads and summarizes your uploaded materials) on Windows, connecting it with AI assistants like Claude Code, Cursor, and more.
[](./LICENSE)
[](https://www.microsoft.com/windows)
[](https://pypi.org/project/notebooklm-mcp-cli/)
🌐 **Language / Language**: [English](./README.en.md)
🔰 For beginners: [`GUIDE.md`](./GUIDE.md) (a comprehensive guide) · [`사용설명서.txt`](./사용설명서.txt) (the shortest)
---
## 📑 Table of Contents
1. [Project Overview](#-project-overview)
2. [Key Features](#-key-features)
3. [Prerequisites / Requirements](#-prerequisites--requirements)
4. [Download / Installation Methods](#-download--installation-methods)
5. [Quick Start (3 minutes)](#-quick-start-3-minutes)
6. [Usage — Menu](#-usage--menu)
7. [Connecting AI Tools (MCP Settings)](#-connecting-ai-tools-mcp-settings)
8. [Command List (Reference)](#-command-list-reference)
9. [Environment Variables](#-environment-variables)
10. [Folder Structure](#-folder-structure)
11. [Build · Test · Deployment](#-build--test--deployment)
12. [Troubleshooting](#-troubleshooting)
13. [Operation · Security Precautions](#-operation--security-precautions)
14. [Uninstallation Method](#-uninstallation-method)
15. [Base Packages](#-base-packages)
16. [License · Copyright · Commercial Use](#-license--copyright--commercial-use)
17. [Disclaimer](#-disclaimer)
---
## 🧭 Project Overview
The **NotebookLM-CLI One-Click Kit** is a one-click installation and execution tool for the [notebooklm-mcp-cli](https://github.com/jacob-bd/notebooklm-mcp-cli) package, which connects Google [NotebookLM](https://notebooklm.google.com) with AI tools like Claude Code, Cursor, VS Code, and Gemini CLI.
- No coding required; simply double-click **`시작하기.bat`** and follow the menu.
- Installation → login → (optional) AI connection → usage, all guided by menu numbers.
| Category | Description |
|---|---|
| Target | Complete beginners with computers and AI |
| Operating System | Windows 10 / 11 (exclusive) |
| Installation Difficulty | ★☆☆ (just double-click and follow numbers) |
| Cost | Kit and original tools **free** (NotebookLM follows Google's policy) |
| Kit License | **Apache-2.0** (commercial use allowed with conditions — [16. License · Copyright · Commercial Use](#-license--copyright--commercial-use)) |
| Original Tool | `notebooklm-mcp-cli` (**MIT License**, separate package) |
---
## ✨ Key Features
| Feature | Description |
|---|---|
| ⚡ One-Click Installation | Automatically detects Python and installs the package using `uv` (preferred) or `pip` |
| 🧭 Easy Start | Guided login, AI connection, and first notebook creation |
| 🔐 Google Login | Automatic Chrome login, cookie file manual login, and profile separation |
| 🚀 MCP Server | Starts MCP server for connection with Claude Code, Cursor, VS Code, and Gemini CLI |
| 📚 Notebook Management | List notebooks, create new notebooks, and execute commands directly |
| 🔄 Update | General and forced updates |
| 🩺 Diagnosis | Automatic diagnosis with `nlm doctor` |
| 🗑️ Complete Removal | Safe removal of package, authentication data, and AI tool connections |
| 📖 Glossary | Explanation of technical terms like MCP and pip |
---
## 🧰 Prerequisites / Requirements
### 3 Prerequisites (manual preparation)
| Item | Why needed | What if not available |
|---|---|---|
| **Internet Connection** | Needed to download the program | Connect to Wi-Fi or LAN |
| **Google Account** | NotebookLM is a Google service (use your Gmail account) | Create a free account at https://accounts.google.com |
| **Chrome** | Used to display the Google login window | Download from https://www.google.com/chrome/ |
### Automatic processing (no need to worry)
- **Python 3.10 ~ 3.13** — The base for the tool; if not installed, the installation guide will be displayed.
- **uv / pip** — Installation helper; automatically used during installation (uv preferred).
- **notebooklm-mcp-cli** — The actual program; automatically downloaded from PyPI.
> 💡 **Important when installing Python**: Check **"Add Python to PATH"** on the first screen.
---
## ⬇️ Download / Installation Methods
### Method 1: Download and extract (recommended)
1. Download **`Code ▸ Download ZIP`** (or Releases) from this repository.
2. Extract the zip file (right-click → "Extract Here"). Do not run from the zip file.
3. In the extracted folder, double-click **`시작하기.bat`** → **`[1] 설치하기`**.
### Method 2: Clone with git
```bash
git clone https://github.com/sodam-ai/NotebookLM-CLI_One-Click_Kit.git
cd NotebookLM-CLI_One-Click_Kit
```
Then, double-click **`시작하기.bat`** → **`[1] 설치하기`**.
> 📌 **.bat files must be in the same folder**. Do not move them separately.
---
## 🚀 Quick Start (3 minutes)
| Step | Action | Description |
|---|---|---|
| 1 | Double-click **`시작하기.bat`** | The menu window will open |
| 2 | **`1`** → Enter | Installation (6 steps, wait until complete) |
| 3 | **`2`** → Enter | The usage menu (RUN) will open |
| 4 | **`S`** → Enter | Easy start — guided login, AI connection, and first notebook |
| 5 | Done! | Now you can use `[1] Start Server`, `[9] List Notebooks`, etc. |
---
## 🖥️ Usage — Menu
### 시작하기.bat (first screen)
| Number | Function |
|---|---|
| 1 | Install (run once) |
| 2 | Use (open usage menu) |
| 3 | View user manual |
| 4 | Uninstall |
| 0 | Close |
### Usage (RUN) Menu — Full
| Number | Function | Description |
|---|---|---|
| **S** | **Easy Start** | For beginners (login → AI connection → first notebook) |
| **T** | **Glossary** | Explains technical terms like MCP and pip |
| 1 | Start MCP Server | Enable AI assistant connection |
| 2 | Google Login | Automatic Chrome login (multiple accounts supported) |
| 3 | Check Login | Verify current login status |
| 4 | Manual Login | Login using cookie file |
| 5 | **Diagnosis** | Automatic diagnosis (`nlm doctor`) |
| 6 | Profile List | View registered accounts |
| 7 | Logout | Delete login information |
| 8 | Direct nlm Command | Execute `nlm` commands directly (advanced) |
| 9 | Notebook List | View your notebooks |
| 10 | Create Notebook | Create a new notebook |
| 11 | AI Mode | Execute `nlm --ai` |
| 12 | Version Check | View installed version |
| 13 | Update | Update to the latest version |
| 14 | Force Latest Update | Force reinstallation of the latest version |
| 15 | **AI Tool Connection** | Automatically connect to Claude Code, Cursor, etc. |
| 16 | Environment Info | View installation and Python locations |
| 0 | Exit | Close the menu |
**Initial steps**: `[1] Install` → `[2] Use` → `[S] Easy Start`.
---
## 🤖 Connecting AI Tools (MCP Settings)
To use NotebookLM with Claude Code, Cursor, etc.:
1. In the usage menu, select **`15`** → Enter
2. Choose **`1`** (Claude Code) / **`2`** (Cursor) / **`3`** (JSON auto) / **`4`** (manual guidance)
3. **Restart the AI tool program** for the changes to take effect.
**Manual JSON configuration** (if automatic connection fails):
```json
{
"mcpServers": {
"notebooklm-mcp": { "command": "notebooklm-mcp" }
}
}
```
**uvx configuration** (execute without installation):
```json
{
"mcpServers": {
"notebooklm-mcp": { "command": "uvx", "args": ["--from", "notebooklm-mcp-cli", "notebooklm-mcp"] }
}
}
```
**Configuration file locations**
| Tool | Configuration file path |
|---|---|
| Claude Desktop | `%APPDATA%\Claude\claude_desktop_config.json` |
| Cursor | `%USERPROFILE%\.cursor\mcp.json` |
| VS Code | `%USERPROFILE%\.vscode\mcp.json` |
| Gemini CLI | `%USERPROFILE%\.gemini\settings.json` |
---
## ⌨️ Command List (Reference)
> **No need to type commands directly** when using the menu. Just use RUN menu `[8]` and type the part after `nlm`.
| Command | Description |
|---|---|
| `nlm login` / `nlm login --check` | Google login / check login status |
| `nlm notebook list` / `nlm notebook create "name"` | List notebooks / create a new notebook |
| `nlm notebook query` | Ask a question in the notebook |
| `nlm source add` | Add materials (URL, text, drive, file) |
| `nlm studio create` | Create content (audio, video, etc.) |
| `nlm download <type>` | Download results |
| `nlm setup add claude-code\|cursor` | Automatically connect AI tools |
| `nlm setup list` / `nlm setup remove <tool>` | List connections / remove connections |
| `nlm doctor` | Automatic diagnosis |
| `nlm --ai` / `nlm --version` | AI mode / version |
| `notebooklm-mcp` | Start MCP server (for AI assistants) |
---
## 🔧 Environment Variables
- **No environment variable settings are required** for this kit. The menu handles installation, login, and connections automatically.
- Related items:
- **PATH** — The path for the computer to find the `nlm` command. Automatically recognized in a new window after installation.
- **Authentication data path** — `%USERPROFILE%\.notebooklm-mcp-cli` (a folder storing Google login information, **only on your PC**).
- No sensitive information like API keys or tokens is stored or sent.
---
## 📂 Folder Structure
```
NotebookLM-CLI_One-Click_Kit/
├── 시작하기.bat ← Main entry point (double-click to start)
├── INSTALL.bat ← Installation script (called by 시작하기 [1])
├── RUN.bat ← Usage menu (called by 시작하기 [2])
├── UNINSTALL.bat ← Uninstallation script (called by 시작하기 [4])
├── README.md ← Korean documentation (this file, GitHub main)
├── README.en.md ← English documentation
├── GUIDE.md ← Korean comprehensive guide for beginners
├── GUIDE.en.md ← English comprehensive guide for beginners
├── 사용설명서.txt ← Shortest user manual in memo format
├── README.pdf / README.en.pdf ← PDF versions of README (same content)
├── GUIDE.pdf / GUIDE.en.pdf ← PDF versions of GUIDE (same content)
├── LICENSE ← Apache License 2.0 text
├── NOTICE ← Copyright, third-party, and trademark notices
├── .gitattributes ← Line ending rules (.bat = CRLF)
└── .gitignore
```
---
## 🏗️ Build · Test · Deployment
This kit consists of **non-compiled Windows batch scripts (.bat) and documentation**.
- **Build**: No build process is required. Use `.bat` files and documentation as is.
- **Testing (execution verification)**: Double-click `시작하기.bat` → `[1] Install` → `[2] Use` → `[5] Diagnosis (nlm doctor)`.
No automated test suite; **verify by actual execution**.
- **Deployment (sharing method)**:
1. Compress this folder into a zip/7z file and share,
2. Download from GitHub using **`Code ▸ Download ZIP`** or `git clone`.
- The user can extract and double-click `시작하기.bat` to start.
---
## 🛠️ Troubleshooting
> 💡 **Most issues can be resolved with RUN menu `[5] Diagnosis`** (`nlm doctor`).
| Symptom | Solution |
|---|---|
| **Window closes immediately** | Check if `.bat` files are in the same folder → extract → try again |
| `nlm` command not found | Not installed yet → `[1] Install` |
| Still not recognized | Close window, restart `시작하기.bat` → `[2]` (PATH update, new window needed) |
| "Python not found" | Install Python — check **"Add Python to PATH"** |
| Login window not shown / failed | Check Chrome → `[7] Logout` → `[2] Login` or `[4] Manual Login` |
| Outdated version | `[14] Force Latest Update` |
| AI tool not shown | **Restart AI tool program** |
| Unknown issue | **`[5] Diagnosis`** → follow the guidance |
---
## 🔒 Operation · Security Precautions
- **Authentication data location**: `%USERPROFILE%\.notebooklm-mcp-cli` stores Google session information.
**Log out** using menu `[7]` when using on a **public PC**.
- **MCP setting manual cleanup**: `UNINSTALL.bat` removes packages and authentication data, but you may need to **manually check and delete** AI tool JSON settings.
- **New cmd window**: After installation, `nlm` is recognized in a **new window** (PATH updated).
- **SmartScreen / Antivirus**: If a warning appears during `.bat` execution, select **"More information → Run"** (or allow).
- **.bat encoding**: Saved in Korean Windows (CP949), **GitHub web may display Korean comments as broken** but **execution is normal**.
- **No sensitive information**: This kit does not store or send passwords, API keys, or tokens.
---
## 🗑️ Uninstallation Method
- Use `[4] Uninstall` in the menu.
---
## 📦 Base Packages
- `notebooklm-mcp-cli` (**MIT License**, separate package)
## 📜 License · Copyright · Commercial Use
- **Apache License 2.0** (allows commercial use with conditions)
## 📝 Disclaimer
- **No warranty**; use at your own risk.
---
(Translation completed)
## 🗑️ Removal Method
1. `start.bat` → **`4`** (Remove) → Enter
2. If you really want to remove, input **`yes`** → Enter
3. 6-step automatic cleanup: Disconnect AI tool → Remove package (uv/pip) → Delete authentication data → Confirm
4. The process is complete when **"Removal Complete"** appears.
> ⚠️ **Do not remove Python itself** (as other programs may use it — intended behavior).
---
## 📦 Base Packages
This toolkit **wraps (installs and runs)** the following open-source packages (not included or redistributed in this kit, retrieved from PyPI):
- **[notebooklm-mcp-cli](https://github.com/jacob-bd/notebooklm-mcp-cli)** by jacob-bd — **MIT License** (PyPI: `notebooklm-mcp-cli`, as of 2026-06 v0.7.6)
---
## ⚖️ License · Copyright · Commercial Use
### This Kit (`.bat` · documentation)
- **License: Apache License 2.0** (full text in [`LICENSE`](./LICENSE))
- **Copyright: Copyright 2026 SoDam AI Studio**
- **Commercial use allowed.** However, when distributing or redistributing, please follow the 4 conditions of Apache-2.0:
1. Include a copy of `LICENSE` · 2. Maintain `NOTICE` notice · 3. Indicate changes if modified · 4. Do not use SoDam AI Studio's name or trademark as an endorser or sponsor
### Original Tool `notebooklm-mcp-cli`
- **License: MIT License** (separate package — not part of this kit). This kit only **downloads from PyPI**, so the tool is subject to its **own MIT License**, and the **original repository's LICENSE is the final reference**.
### Trademarks
- "NotebookLM", "Google", "Chrome" are trademarks of **Google LLC**, "Claude" is a trademark of **Anthropic**, and "Cursor" is a trademark of its owner.
- This kit is an unofficial helper that is **not affiliated, endorsed, or sponsored** by the above companies, and trademarks are used for identification purposes only.
---
## ⚠️ Disclaimer
- This kit is merely a helper for installing and running the public package `notebooklm-mcp-cli`.
- NotebookLM is a **Google service**, and its use is subject to **Google's Terms of Service**. You are responsible for using automation tools.
- This kit is provided **"as is"** without any warranties. The creator is not responsible for **data loss, account issues**, etc.
- Your Google login information is stored **only on your computer**, and this kit does not arbitrarily access system folders.
---
## 🙋 Inquiries / Contributions
Issues · Pull Requests are welcome → [GitHub Issues](https://github.com/sodam-ai/NotebookLM-CLI_One-Click_Kit/issues)
— **Apache-2.0** · Copyright 2026 **SoDam AI Studio**
