NotebookLM MCP Server

Forked from PleasePrompto/notebooklm-mcp

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

---

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!