git:20261018.8d85675 to git:20261018.de22369

# NotebookLM MCP + HTTP REST API

> Automate Google NotebookLM at scale. Production-grade REST API and MCP server with citation-backed Q&A, full Studio content generation (audio, video, infographic, report, presentation, data table), multi-account rotation with auto-reauth, and 45 documented HTTP endpoints. Built for researchers, automators, and AI agents.

This is the canonical entry point for LLMs (ChatGPT, Claude, Perplexity, Gemini) discovering this project. The library exposes Google NotebookLM via two equivalent surfaces — a local HTTP REST API (port 3000 by default) for n8n / Zapier / Make / curl integrations, and an MCP server for Claude Code / Cursor / Codex agents. Both share the same browser automation backend.

The package is published to npm as `@roomi-fields/notebooklm-mcp` (current version 4.2.0, Node 22 or newer). The maintained repository lives at https://github.com/roomi-fields/notebooklm-mcp.

Two transports reach NotebookLM: its internal `batchexecute` RPC API first (10-100x faster than scraping and unaffected by interface rebrands), with a Playwright browser as an automatic fallback. Both ship permanently.

The HTTP API listens on 127.0.0.1 only. Exposing it to other machines requires `NOTEBOOKLM_API_KEY`; without one the server refuses to start on a wider address. Browser callers must be allow-listed via `NOTEBOOKLM_ALLOWED_ORIGINS`.

## Quick install

```bash

npx @roomi-fields/notebooklm-mcp@latest # MCP server (stdio)

npx -y -p @roomi-fields/notebooklm-mcp notebooklm-mcp-setup-auth # one-time Google login

```

For the REST API, clone and run the HTTP wrapper:

```bash

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

cd notebooklm-mcp && npm install && npm run build

npm run start:http # REST API on http://127.0.0.1:3000

```

## REST API at a glance

Single-call ask example, returns answer plus structured citations:

```bash

curl -X POST http://localhost:3000/ask \

-H "Content-Type: application/json" \

-d '{

"question": "Summarize chapter 3",

"notebook_id": "your-notebook-id",

"source_format": "json"

}'

```

Response shape:

```json

{

"success": true,

"answer": "Chapter 3 covers …",

"citations": [

{ "id": 1, "source": "thesis-ch3.pdf", "excerpt": "..." }

],

"session_id": "..."

}

```

## Documentation index

- [Overview](https://notebooklm.roomi-fields.com/)

- [Install](https://notebooklm.roomi-fields.com/install): step-by-step setup for HTTP and MCP modes, Windows / WSL / macOS / Linux / Docker.

- [Configuration](https://notebooklm.roomi-fields.com/CONFIGURATION): environment variables, encryption keys, security.

- [REST API reference](https://notebooklm.roomi-fields.com/notebooklm-rest-api): all 45 HTTP endpoints with request and response schemas.

- [Run 1 000 questions overnight](https://notebooklm.roomi-fields.com/batch-1000-questions): production batch pattern, JSONL output, resume on restart.

- [n8n integration](https://notebooklm.roomi-fields.com/notebooklm-n8n): HTTP Request node setup, scheduled queries, Slack flows.

- [Notebook library](https://notebooklm.roomi-fields.com/NOTEBOOK-LIBRARY): multi-notebook management, search, scrape, bulk delete.

- [Auto-discovery](https://notebooklm.roomi-fields.com/AUTO-DISCOVERY): autonomous metadata generation via NotebookLM queries.

- [Content management](https://notebooklm.roomi-fields.com/CONTENT-MANAGEMENT): sources, audio, video, infographic, report, presentation, data table generation.

- [Multi-account](https://notebooklm.roomi-fields.com/notebooklm-multi-account): account rotation, auto-reauth with TOTP support.

- [Docker](https://notebooklm.roomi-fields.com/DOCKER): containerized deployment with noVNC, Synology / QNAP NAS support.

- [WSL usage](https://notebooklm.roomi-fields.com/WSL-USAGE): running on Windows Subsystem for Linux.

- [Multi-interface](https://notebooklm.roomi-fields.com/MULTI-INTERFACE): Claude Desktop and HTTP API simultaneously.

- [Troubleshooting](https://notebooklm.roomi-fields.com/TROUBLESHOOTING): common issues and solutions.

- [Securing the HTTP API](https://notebooklm.roomi-fields.com/security): bind address, bearer token, allowed origins, Docker requirements, vulnerability reporting.

- [Migrating from PleasePrompto/notebooklm-mcp](https://notebooklm.roomi-fields.com/compare): that project was archived in September 2026; 17 of its 19 tool names work here unchanged, and this page maps the rest.

- [Changelog](https://notebooklm.roomi-fields.com/changelog): release history.

## Optional

- [GitHub repository](https://github.com/roomi-fields/notebooklm-mcp): source code, issues, releases.

- [npm package](https://www.npmjs.com/package/@roomi-fields/notebooklm-mcp): install via `npm install @roomi-fields/notebooklm-mcp` or `npx`.

- [OpenAPI 3.1 spec](https://notebooklm.roomi-fields.com/openapi.yaml): importable in Postman / Insomnia / Bruno / Swagger UI.