notebooklm-mcp-secure

💡 Gemini API is completely optional!All core NotebookLM features (ask_question, notebooks, sessions, audio) work via browser automation withno API key required. The Gemini tools below are bonus features for users who want direct API access.

# Only required if you want Gemini API features (deep_research, gemini_query, upload_document) GEMINI_API_KEY=your-api-key # Get from https://aistudio.google.com/apikey # Optional settings GEMINI_DEFAULT_MODEL=gemini-3-flash-preview # Default model (was gemini-2.5-flash) GEMINI_DEEP_RESEARCH_ENABLED=true # Enable Deep Research GEMINI_TIMEOUT_MS=30000 # API timeout

Upload and query documents directly via Gemini API — no browser automation needed.

v1.9.0 introduces theGemini Files APIfor fast, reliable document analysis. Upload PDFs, analyze them instantly, and delete when done.

Upload any document to Gemini for instant querying:

- Supported: PDF (50MB, 1000 pages), TXT, MD, HTML, CSV, JSON, DOCX, images, audio, video
- 48-hour retention— files auto-expire, or delete manually
- Returns a file ID for querying

query_document— Ask Questions About Documents

"What are the main findings in this research paper?" "Summarize section 3 of the document" "Extract all statistics mentioned in the PDF"

- Full document understanding (text, tables, charts, diagrams)
- Multi-document queries (compare multiple files)
- Fast API response (no browser wait)

Shows file names, sizes, MIME types, and expiration times.

delete_document— Clean Up Sensitive Files

Immediately remove files (don't wait for 48h expiration).

1. upload_document("/research/paper.pdf") → Returns: files/abc123 2. query_document("files/abc123", "What methodology was used?") → Returns: "The paper uses a mixed-methods approach combining..." 3. query_document("files/abc123", "List all cited authors") → Returns: "Smith et al. (2024), Johnson (2023)..." 4. delete_document("files/abc123") → File removed

No file size limits— PDFs of any size are automatically handled.

When you upload a PDF that exceeds Gemini's limits (50MB or 1000 pages), the system automatically:
- Detectsthe oversized PDF
- Splitsit into optimal chunks (500 pages each)
- Uploadsall chunks in parallel
- Returnschunk metadata for querying

upload_document("/research/massive-2000-page-report.pdf") → Returns: { "wasChunked": true, "totalPages": 2000, "chunks": [ { "fileName": "files/abc1", "pageStart": 1, "pageEnd": 500 }, { "fileName": "files/abc2", "pageStart": 501, "pageEnd": 1000 }, { "fileName": "files/abc3", "pageStart": 1001, "pageEnd": 1500 }, { "fileName": "files/abc4", "pageStart": 1501, "pageEnd": 2000 } ], "allFileNames": ["files/abc1", "files/abc2", "files/abc3", "files/abc4"] }

query_chunked_document— Query All Chunks at Once

For chunked documents, use this tool to query all parts and get an aggregated answer:

query_chunked_document( file_names: ["files/abc1", "files/abc2", "files/abc3", "files/abc4"], query: "What are the key recommendations in this report?" ) → Queries each chunk, then synthesizes a unified answer

Programmatic Notebook Creation (v1.7.0+)

Create NotebookLM notebooks entirely from code — no manual clicks required.

create_notebook— Build Notebooks Instantly

Create a complete notebook with multiple sources in one command:

{ "name": "Security Research 2025", "sources": [ { "type": "url", "value": "https://owasp.org/Top10" }, { "type": "file", "value": "/path/to/security-report.pdf" }, { "type": "text", "value": "Custom analysis notes...", "title": "My Notes" } ], "description": "OWASP security best practices", "topics": ["security", "owasp", "vulnerabilities"] }

- URL— Web pages, documentation, articles
- File— PDF, DOCX, TXT, and more
- Text— Raw text, code snippets, notes

Createup to 10 notebooksin a single operation:

{ "notebooks": [ { "name": "React Docs", "sources": [{ "type": "url", "value": "https://react.dev/reference" }] }, { "name": "Node.js API", "sources": [{ "type": "url", "value": "https://nodejs.org/api/" }] }, { "name": "TypeScript Handbook", "sources": [{ "type": "url", "value": "https://www.typescriptlang.org/docs/" }] } ] }

- Setting up project documentation libraries
- Onboarding new team members with curated knowledge bases
- Creating topic-specific research notebooks in bulk

manage_sources— Dynamic Source Management

Add or remove sources from existing notebooks:

{ "notebook_id": "abc123", "action": "add", "sources": [{ "type": "url", "value": "https://new-documentation.com" }] }

generate_audio— Audio Overview Creation

Generate NotebookLM's famous "Audio Overview" podcasts programmatically:

"Generate an audio overview for my Security Research notebook"

Sync notebook sources from a local directory: