NotebookLM-MCP

Automatic setup — picks the right config for each tool

nlm setup add claude-code nlm setup add gemini nlm setup add github-copilot nlm setup add cursor nlm setup add cline nlm setup add antigravity

Installation

🆕 Claude Desktop users: Download the extension (.mcpb file) → double-click → done! One-click install, no config needed.

Install from PyPI. This single package includes both the CLI and MCP server:

Using uvx (Run Without Install)

uvx --from notebooklm-mcp-cli nlm --help
uvx --from notebooklm-mcp-cli notebooklm-mcp

Install with uv

uv tool install . ``` </details>

Step 1: Check What You Have Installed

uv tool list | grep notebooklm

Legacy packages to remove: <div class="rdm-tbl-wrap"><table class="rdm-tbl"><thead><tr><th>Package</th><th>What it was</th></tr></thead><tbody><tr><td>notebooklm-cli</td><td>Old CLI-only package</td></tr><tr><td>notebooklm-mcp-server</td><td>Old MCP-only package</td></tr></tbody></table></div>

Step 2: Uninstall Legacy Packages

```bash

Remove old CLI package (if installed)

uv tool uninstall notebooklm-cli

Remove old MCP package (if installed)

uv tool uninstall notebooklm-mcp-server ```

Step 3: Reinstall the Unified Package

After removing legacy packages, reinstall to fix symlinks:

uv tool install --force notebooklm-mcp-cli

Why --force? When multiple packages provide the same executable, uv can leave broken symlinks after uninstalling. The --force flag ensures clean symlinks.

Step 4: Verify Installation

uv tool list | grep notebooklm

You should see only:

notebooklm-mcp-cli v0.2.0
- nlm
- notebooklm-mcp

Getting Started

If you are setting up the tool for the first time — or migrating from a browser-based NotebookLM MCP — see the Getting Started Guide. It covers install, login, agent registration, and a step-by-step migration path that avoids the "two NotebookLM servers registered" trap.

Uninstalling

To completely remove the MCP:

```bash

Automatic Setup (Recommended)

Use nlm setup to automatically configure the MCP server for your AI tools — no manual JSON editing required:

```bash

Diagnose installation & auth issues

nlm doctor ```

Install AI Skills (Optional)

Install the NotebookLM expert guide for your AI assistant to help it use the tools effectively. Supported for Cline, Antigravity, OpenClaw, Codex, OpenCode, Claude Code, and Gemini CLI.

```bash

Install skill files

nlm skill install cline nlm skill install openclaw nlm skill install codex nlm skill install antigravity

Using uvx (No Install Required)

If you don't want to install the package, you can use uvx to run on-the-fly:

```bash

`uv tool upgrade` Not Installing Latest Version

Symptoms: - Running uv tool upgrade notebooklm-mcp-cli installs an older version (e.g., 0.1.5 instead of 0.1.9) - uv cache clean doesn't fix the issue

Why this happens: uv tool upgrade respects version constraints from your original installation. If you initially installed an older version or with a constraint, upgrade stays within those bounds by design.

Fix — Force reinstall:

uv tool install --force notebooklm-mcp-cli

This bypasses any cached constraints and installs the absolute latest version from PyPI.

Verify: ```bash uv tool list | grep notebooklm

MCP Demos

Generate JSON config for any other tool

nlm setup add json ```

Then use natural language: "Create a notebook about quantum computing and generate a podcast"

Remove cached auth tokens and data (optional)

rm -rf ~/.notebooklm-mcp-cli

Also remove from your AI tools:

... or any configured tool

```

MCP Configuration

⚠️ Context Window Warning: This MCP provides 35 tools. Disable it when not using NotebookLM to preserve context. In Claude Code: @notebooklm-mcp to toggle.

Generate JSON config for any other tool

nlm setup add json

Check which tools are configured

nlm setup list

NotebookLM CLI & MCP Server

🎉 January 2026 — Major Update! This project has been completely refactored to unify NotebookLM-MCP and NotebookLM-CLI into a single, powerful package. One install gives you both the CLI (nlm) and MCP server (notebooklm-mcp). See the CLI Guide and MCP Guide for full documentation.

Programmatic access to Google NotebookLM — via command-line interface (CLI) or Model Context Protocol (MCP) server.

Note: Tested with Pro/free and Google AI Ultra ($249/mo) tier accounts. May work with NotebookLM Enterprise accounts but has not been tested.

📺 Watch the Demos

CLI Demos

🖥️ Command-Line Interface (CLI)

Use nlm directly in your terminal for scripting, automation, or interactive use:

nlm notebook list                              # List all notebooks
nlm notebook create "Research Project"         # Create a notebook
nlm source add <notebook> --url "https://..."  # Add sources
nlm audio create <notebook> --confirm          # Generate podcast
nlm download audio <notebook> <artifact-id>    # Download audio file
nlm share public <notebook>                    # Enable public link

Run nlm --ai for comprehensive AI-assistant documentation.

CLI Authentication (Recommended)

```bash

Run CLI commands directly

uvx --from notebooklm-mcp-cli nlm setup add cursor uvx --from notebooklm-mcp-cli nlm login

For tools that use JSON config, point them to uvx:

<details>
<summary>Manual Setup (if you prefer)</summary>

> **Tip:** Run `nlm setup add json` for an interactive wizard that generates the right JSON snippet for your tool.

**Claude Code / Gemini CLI** support adding MCP servers via their own CLI:

**Cursor / Windsurf** resolve commands from your `PATH`, so the command name is enough:

| Tool | Config Location |
|------|-----------------|
| Cursor | `~/.cursor/mcp.json` |
| Windsurf | `~/.codeium/windsurf/mcp_config.json` |

**GitHub Copilot (VS Code workspace)** uses `.vscode/mcp.json` with a top-level `servers` key:

**Claude Desktop** may not resolve `PATH` — use the full path to the binary:

Find your path with: which notebooklm-mcp

</details>

📚 Full configuration details: MCP Guide — Server options, environment variables, HTTP transport, multi-user setup, and context window management.

Should show: notebooklm-mcp-cli v0.1.9 (or latest)

```

Troubleshooting