Skip to main content
Glama

NotebookLM MCP Server

Forked from PleasePrompto/notebooklm-mcp

Full automation of Google NotebookLM: Q&A, audio podcasts, and source management

CI npm version npm downloads codecov License: MIT TypeScript Node.js

MCP Claude Code n8n GitHub


Features

Q&A with Citations

  • Ask questions to NotebookLM and get accurate, citation-backed answers

  • Source citation extraction with 5 formats: none, inline, footnotes, json, expanded

  • Session management for multi-turn conversations

Content Generation

Generate multiple content types from your notebook sources:

Content Type

Formats

Options

Audio Overview

Podcast-style discussion

Language (80+), custom instructions

Video

Brief, Explainer

6 visual styles, language, custom instructions

Infographic

Horizontal, Vertical

Language, custom instructions

Report

Summary, Detailed

Language, custom instructions

Presentation

Overview, Detailed

Language, custom instructions

Data Table

Simple, Detailed

Language, custom instructions

Video Visual Styles: classroom, documentary, animated, corporate, cinematic, minimalist

Content Download

  • Download Audio — WAV audio files

  • Download Video — MP4 video files

  • Download Infographic — PNG image files

  • Text-based content (report, presentation, data_table) is returned in the API response

Source Management

  • Add sources: Files (PDF, TXT, DOCX), URLs, Text, YouTube videos, Google Drive

  • List sources: View all sources in a notebook

Notebook Library

  • Multi-notebook management with validation and smart selection

  • Auto-discovery: Automatically generate metadata via NotebookLM queries

  • Search notebooks by keyword in name, description, or topics

  • Scrape notebooks: List all notebooks from NotebookLM with IDs and names

  • Bulk delete: Delete multiple notebooks at once

Integration Options

  • MCP Protocol — Claude Code, Cursor, Codex, any MCP client

  • HTTP REST API — n8n, Zapier, Make.com, custom integrations

  • Docker — Isolated deployment with Docker or Docker Compose


Quick Start

Option 1: MCP Mode (Claude Code, Cursor, Codex)

# Clone and build locally git clone https://github.com/roomi-fields/notebooklm-mcp.git cd notebooklm-mcp npm install && npm run build # Claude Code claude mcp add notebooklm node /path/to/notebooklm-mcp/dist/index.js # Cursor - add to ~/.cursor/mcp.json { "mcpServers": { "notebooklm": { "command": "node", "args": ["/path/to/notebooklm-mcp/dist/index.js"] } } }

Then say: "Log me in to NotebookLM" → Chrome opens → log in with Google.

Option 2: HTTP REST API (n8n, Zapier, Make.com)

git clone https://github.com/roomi-fields/notebooklm-mcp.git cd notebooklm-mcp npm install && npm run build npm run setup-auth # One-time Google login npm run start:http # Start server on port 3000
# Query the API curl -X POST http://localhost:3000/ask \ -H "Content-Type: application/json" \ -d '{"question": "Explain X", "notebook_id": "my-notebook"}'

Option 3: Docker (NAS, Server)

# Build and run docker build -t notebooklm-mcp . docker run -d --name notebooklm-mcp -p 3000:3000 -p 6080:6080 -v notebooklm-data:/data notebooklm-mcp # Authenticate via noVNC # 1. Open http://localhost:6080/vnc.html # 2. Run: curl -X POST http://localhost:3000/setup-auth -d '{"show_browser":true}' # 3. Login to Google in the VNC window

See Docker Guide for NAS deployment (Synology, QNAP).


Documentation

Guide

Description

Installation

Step-by-step setup for HTTP and MCP modes

Configuration

Environment variables and security

API Reference

Complete HTTP endpoint documentation

n8n Integration

Workflow automation setup

Troubleshooting

Common issues and solutions

Notebook Library

Multi-notebook management

Auto-Discovery

Autonomous metadata generation

Docker

Docker and Docker Compose deployment

Multi-Interface

Run Claude Desktop + HTTP simultaneously

Chrome Limitation

Profile locking (solved in v1.3.6+)

Adding a Language

i18n system for multilingual UI support


Roadmap

See ROADMAP.md for planned features and version history.

Latest releases:

  • v1.5.3 — Docker deployment with noVNC for visual authentication + NAS support (Synology, QNAP)

  • v1.5.2 — Notebook scraping from NotebookLM + Bulk delete + Bug fixes

  • v1.5.1 — Multilingual UI support (FR/EN) with i18n selector system + E2E tests (76 tests)

  • v1.5.0 — Complete Studio content generation (video, infographic, presentation, data_table) + Notes management + Delete sources

  • v1.4.0 — Content management (sources, audio, generation) + Multi-account

Not yet implemented:

  • Discover sources (Web/Drive search with Fast/Deep modes)

  • Edit notes (create, delete, and convert are implemented)


Disclaimer

This tool automates browser interactions with NotebookLM. Use a dedicated Google account for automation. CLI tools like Claude Code can make mistakes — always review changes before deploying.

See full Disclaimer below.


Contributing

Found a bug? Have an idea? Open an issue or submit a PR!

See CONTRIBUTING.md for guidelines.

License

MIT — Use freely in your projects. See LICENSE.

Author

Romain Peyrichou@roomi-fields


About browser automation: While I've built in humanization features (realistic typing speeds, natural delays, mouse movements), I can't guarantee Google won't detect or flag automated usage. Use a dedicated Google account for automation.

About CLI tools and AI agents: CLI tools like Claude Code, Codex, and similar AI-powered assistants are powerful but can make mistakes:

  • Always review changes before committing or deploying

  • Test in safe environments first

  • Keep backups of important work

  • AI agents are assistants, not infallible oracles

I built this tool for myself and share it hoping it helps others, but I can't take responsibility for any issues that might occur. Use at your own discretion.


Built with frustration about hallucinated APIs, powered by Google's NotebookLM

Star on GitHub if this saves you debugging time!

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/roomi-fields/notebooklm-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server