Data

Tools

Indexes

Applications

Experiments

Awesome

An open API service indexing awesome lists of open source software.

https://github.com/roomi-fields/notebooklm-mcp

Google NotebookLM over MCP + a local HTTP REST API. Citation-backed Q&A, audio/video/content generation, multi-account rotation. For Claude Code, Codex, Cursor, n8n, Zapier, Make.
https://github.com/roomi-fields/notebooklm-mcp

ai anthropic automation citations claude claude-code gemini google-notebooklm http-api mcp mcp-server n8n notebooklm playwright rest-api typescript

Last synced: 9 days ago
JSON representation

Google NotebookLM over MCP + a local HTTP REST API. Citation-backed Q&A, audio/video/content generation, multi-account rotation. For Claude Code, Codex, Cursor, n8n, Zapier, Make.

Awesome Lists containing this project

README 

          



# NotebookLM MCP + HTTP REST API



**Google NotebookLM over MCP + a local HTTP REST API — Q&A with citations, audio podcasts, video generation, multi-account rotation. Works with Claude Code, Codex, Cursor, n8n, Zapier, Make.**



> 🟢 **Actively maintained fork** of [PleasePrompto/notebooklm-mcp](https://github.com/PleasePrompto/notebooklm-mcp) (upstream last push: 2025-12-27). This fork ships v1.5.8 (2026-04-19) with 2026 NotebookLM UI selectors, HTTP REST API for n8n / Zapier / Make, multi-account rotation, and documented install on Windows / WSL / Docker.



[![CI](https://github.com/roomi-fields/notebooklm-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/roomi-fields/notebooklm-mcp/actions/workflows/ci.yml) [![npm version](https://badge.fury.io/js/%40roomi-fields%2Fnotebooklm-mcp.svg)](https://www.npmjs.com/package/@roomi-fields/notebooklm-mcp) [![npm downloads](https://img.shields.io/npm/dm/@roomi-fields/notebooklm-mcp.svg)](https://www.npmjs.com/package/@roomi-fields/notebooklm-mcp) [![codecov](https://codecov.io/gh/roomi-fields/notebooklm-mcp/branch/main/graph/badge.svg)](https://codecov.io/gh/roomi-fields/notebooklm-mcp) [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT) [![TypeScript](https://img.shields.io/badge/TypeScript-5.x-blue.svg)](https://www.typescriptlang.org/) [![Node.js](https://img.shields.io/badge/Node.js->=18-green.svg)](https://nodejs.org/)



[![MCP](https://img.shields.io/badge/MCP-2025-green.svg)](https://modelcontextprotocol.io/) [![Claude Code](https://img.shields.io/badge/Claude_Code-MCP-8A2BE2)](https://claude.ai/claude-code) [![n8n](https://img.shields.io/badge/n8n-HTTP_API-orange)](./deployment/docs/04-N8N-INTEGRATION.md) [![GitHub](https://img.shields.io/github/stars/roomi-fields/notebooklm-mcp?style=social)](https://github.com/roomi-fields/notebooklm-mcp)






---



## 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 (97% excerpt success rate)

- **Session management** for multi-turn conversations with auto-reauth on session expiry



### 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)



```bash

# 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)



```bash

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

```



```bash

# 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)



```bash

# 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](./deployment/docs/08-DOCKER.md) for NAS deployment (Synology, QNAP).



---



## Documentation



| Guide                                                        | Description                               |

| ------------------------------------------------------------ | ----------------------------------------- |

| [Installation](./deployment/docs/01-INSTALL.md)              | Step-by-step setup for HTTP and MCP modes |

| [Configuration](./deployment/docs/02-CONFIGURATION.md)       | Environment variables and security        |

| [API Reference](./deployment/docs/03-API.md)                 | Complete HTTP endpoint documentation      |

| [n8n Integration](./deployment/docs/04-N8N-INTEGRATION.md)   | Workflow automation setup                 |

| [Troubleshooting](./deployment/docs/05-TROUBLESHOOTING.md)   | Common issues and solutions               |

| [Notebook Library](./deployment/docs/06-NOTEBOOK-LIBRARY.md) | Multi-notebook management                 |

| [Auto-Discovery](./deployment/docs/07-AUTO-DISCOVERY.md)     | Autonomous metadata generation            |

| [Docker](./deployment/docs/08-DOCKER.md)                     | Docker and Docker Compose deployment      |

| [Multi-Interface](./deployment/docs/09-MULTI-INTERFACE.md)   | Run Claude Desktop + HTTP simultaneously  |

| [Chrome Limitation](./docs/CHROME_PROFILE_LIMITATION.md)     | Profile locking (solved in v1.3.6+)       |

| [Adding a Language](./docs/ADDING_A_LANGUAGE.md)             | i18n system for multilingual UI support   |



---



## Roadmap



See [ROADMAP.md](./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](#disclaimer-details) below.



---



## Contributing



Found a bug? Have an idea? [Open an issue](https://github.com/roomi-fields/notebooklm-mcp/issues) or submit a PR!



See [CONTRIBUTING.md](./CONTRIBUTING.md) for guidelines.



## License



MIT — Use freely in your projects. See [LICENSE](./LICENSE).



## Author



**Romain Peyrichou** — [@roomi-fields](https://github.com/roomi-fields)



---



Full Disclaimer



**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](https://github.com/roomi-fields/notebooklm-mcp) if this saves you debugging time!