AN

alfredang/notebooklm-mcp

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

61 stars 37 forks Качество 55 Тренд 14

alfredang/notebooklm-mcp - кандидат на сервер MCP, импортированный из https://github.com/alfredang/notebooklm-mcp.

Обзор

alfredang/notebooklm-mcp - кандидат на сервер MCP, импортированный из https://github.com/alfredang/notebooklm-mcp.

Обзор (машинный перевод)

Мощный сервер MCP (Model Context Protocol), который переносит Google NotebookLM в Claude Desktop и Claude Code.

Особенности

Исследование: Список и создание блокнотов Контент: Добавьте URL-адреса, текст и файлы в качестве источников Поколение: Создание подкастов, видео, слайдов, Mind Maps, инфографики, Quizzes, Flashcards и Reports ** Природное взаимодействие**: Общайтесь напрямую с вашими источниками, используя рассуждения Клода.

Предпосылки

###1.Установите uv (Python Package Manager)

macOS / Linux

Место установки по умолчанию: ~/.local/bin/uv

Windows

Место установки по умолчанию: %USERPROFILE%\.local\bin\uv.exe

Проверьте установку:

###2.Клонирование и установка зависимостей

Это будет: Создание виртуальной среды .venv Установите notebooklm-py (клиент Python для API NotebookLM)

  • Установить fastmcp (фреймворк сервера MCP)

**Примечание: ** Эти зависимости необходимы как для Claude Desktop, так и для Claude Code.

Шаг 1: Аутентификация с помощью NotebookLM

NotebookLM использует аутентификацию на основе браузера. Вы должны войти один раз, чтобы сохранить свои сеансовые куки.

** Что происходит: ** 1 Окно браузера откроется автоматически 2. Войдите в свою учетную запись Google 3.

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

NotebookLM MCP for Claude (Desktop & CLI)

A powerful MCP (Model Context Protocol) server that brings Google NotebookLM into Claude Desktop and Claude Code.

Features

  • Research: List and create notebooks
  • Content: Add URLs, text, and files as sources
  • Generation: Create Podcasts, Videos, Slides, Mind Maps, Infographics, Quizzes, Flashcards, and Reports
  • Natural Interaction: Chat directly with your sources using Claude’s reasoning

Prerequisites

1. Install uv (Python Package Manager)

Verify installation:

uv --version

2. Clone and Install Dependencies

# Clone the repository
git clone https://github.com/alfredang/notebooklm-mcp.git

# Navigate to the project folder
cd notebooklm-mcp

# Install dependencies (includes notebooklm-py and fastmcp)
uv sync

This will:

  • Create a .venv virtual environment
  • Install notebooklm-py (Python client for NotebookLM API)
  • Install fastmcp (MCP server framework)

Note: These dependencies are required for both Claude Desktop and Claude Code.


Step 1: Authenticate with NotebookLM

NotebookLM uses browser-based authentication. You must login once to save your session cookies.

cd notebooklm-mcp
uv run notebooklm login

What happens:

  1. A browser window will open automatically
  2. Log in to your Google account
  3. Navigate to NotebookLM if not redirected automatically
  4. Wait until the terminal displays “Success”
  5. Close the browser

Verify authentication:

uv run python -c "
from notebooklm import NotebookLMClient
import asyncio
async def test():
    client = await NotebookLMClient.from_storage()
    async with client:
        notebooks = await client.notebooks.list()
        print(f'Authenticated! Found {len(notebooks)} notebooks.')
asyncio.run(test())
"

You should see: Authenticated! Found X notebooks.


Step 2: Test the MCP Server

Before configuring Claude, verify the server starts correctly:

cd notebooklm-mcp
uv run python server.py

Expected output:

Starting NotebookLM MCP server...
NotebookLM client initialized successfully
Starting MCP server 'NotebookLM' with transport 'stdio'

Press Ctrl+C (or Cmd+C on Mac) to stop the server after confirming it works.


Step 3: Setup for Claude Desktop

3.1 Find Your Paths

You’ll need two paths for the configuration:

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "notebooklm": { "command": "<UV_PATH>", "args": [ "--directory", "<PROJECT_PATH>", "run", "python", "server.py" ] } } }