NotebookLM REST API reference — 33 HTTP endpoints

Complete reference for the NotebookLM HTTP REST API. Citation-backed Q&A, Studio content generation, notebook library, multi-account, sessions.

OpenAPI 3.1 spec: openapi.yaml (importable in Postman, Insomnia, Bruno, Swagger UI). Source in the repo at deployment/docs/openapi.yaml.

Companion guides: REST batch pattern (1 000 questions overnight) · n8n integration · Multi-account rotation · Compare with PleasePrompto/notebooklm-mcp v2.0.0

🌐 Base URL

http://localhost:3000

Or for network access: http://<SERVER-IP>:3000

Available Endpoints (33 total)

Authentication

Method	Endpoint	Description
`POST`	`/setup-auth`	First-time authentication
`POST`	`/de-auth`	Logout (clear credentials)
`POST`	`/re-auth`	Re-authenticate / switch account
`POST`	`/cleanup-data`	Clean all data (requires confirm)

Queries

Method	Endpoint	Description
`GET`	`/health`	Server health check
`POST`	`/ask`	Ask a question to NotebookLM

Notebooks

Method	Endpoint	Description
`GET`	`/notebooks`	List all notebooks
`POST`	`/notebooks`	Add a notebook manually
`POST`	`/notebooks/create`	Create a new notebook in NotebookLM
`POST`	`/notebooks/auto-discover`	Auto-generate notebook metadata
`GET`	`/notebooks/scrape`	Scrape notebooks from NotebookLM
`POST`	`/notebooks/import-from-scrape`	Bulk import scraped notebooks
`GET`	`/notebooks/search`	Search notebooks by query
`GET`	`/notebooks/stats`	Get library statistics
`GET`	`/notebooks/:id`	Get notebook details
`PUT`	`/notebooks/:id`	Update notebook metadata
`DELETE`	`/notebooks/:id`	Delete a notebook
`PUT`	`/notebooks/:id/activate`	Activate a notebook (set as default)

Sessions

Method	Endpoint	Description
`GET`	`/sessions`	List active sessions
`POST`	`/sessions/:id/reset`	Reset session history
`DELETE`	`/sessions/:id`	Close a session

Content Management

Method	Endpoint	Description
`POST`	`/content/sources`	Add source/document to notebook
`DELETE`	`/content/sources/:id`	Delete source by ID
`DELETE`	`/content/sources`	Delete source by name (query param)
`POST`	`/content/generate`	Generate content (audio, video, report, etc.)
`GET`	`/content/download`	Download/export content
`POST`	`/content/notes`	Create a note in the notebook
`POST`	`/content/chat-to-note`	Save chat discussion to a note
`POST`	`/content/notes/:title/to-source`	Convert note to source
`GET`	`/content`	List sources and generated content

Note: v1.5.0 consolidated content generation into /content/generate with all NotebookLM Studio features (audio_overview, video, infographic, report, presentation, data_table).

1. Health Check

`GET /health`

Check server and authentication status.

Request:

curl http://localhost:3000/health

Success Response (200):

{
  "success": true,
  "data": {
    "authenticated": true,
    "sessions": 2,
    "library_notebooks": 3,
    "context_age_hours": 0.25
  }
}

Error Response (500):

{
  "success": false,
  "error": "Error message here"
}

Fields:

authenticated - Valid Google session
sessions - Number of active sessions
library_notebooks - Number of configured notebooks
context_age_hours - Browser context age (hours)

2. Ask Question

`POST /ask`

Ask a question to NotebookLM and get a response.

Request:

curl -X POST http://localhost:3000/ask \
  -H "Content-Type: application/json" \
  -d '{
    "question": "What are the main tips for parents?",
    "notebook_id": "parents-numerique"
  }'

Body Parameters:

Parameter	Type	Required	Description
`question`	string	✅ Yes	The question to ask
`notebook_id`	string	❌ No	Notebook ID (or URL)
`notebook_url`	string	❌ No	Direct notebook URL
`session_id`	string	❌ No	Reuse an existing session
`show_browser`	boolean	❌ No	Show Chrome (debug)
`source_format`	string	❌ No	Citation extraction format (see below)

Source Format Options:

Format	Description	Example Output
`none`	No extraction (default, fastest)	`"text[1]..."`
`inline`	Insert source text inline	`"text[1: "source excerpt..."]..."`
`footnotes`	Append sources at the end	Answer + `---\nSources:\n[1] text...`
`json`	Return sources as separate object	`{ answer: "...", sources: { citations } }`
`expanded`	Replace markers with full quoted text	`"text "full source quote..."..."`

Success Response (200):

{
  "success": true,
  "data": {
    "status": "success",
    "question": "What advice for parents in the digital age?",
    "answer": "Empathy is a fundamental concept...",
    "session_id": "9a580eee",
    "notebook_url": "https://notebooklm.google.com/notebook/xxx",
    "session_info": {
      "age_seconds": 44,
      "message_count": 1,
      "last_activity": 1763737756057
    }
  }
}

Success Response with Sources (200):

When using source_format other than none:

{
  "success": true,
  "data": {
    "status": "success",
    "question": "What is the main topic?",
    "answer": "The Self is the core essence[1: \"The Self is the seat of consciousness...\"]...",
    "session_id": "abc123",
    "notebook_url": "https://notebooklm.google.com/notebook/xxx",
    "session_info": { ... },
    "sources": {
      "format": "inline",
      "citations": [
        {
          "marker": "[1]",
          "number": 1,
          "sourceText": "The Self is the seat of consciousness that possesses the 8 C's..."
        }
      ],
      "extraction_success": true
    }
  }
}

Error Response (400):

{
  "success": false,
  "error": "Missing required field: question"
}

Error Response (500):

{
  "success": false,
  "error": "Timeout waiting for response from NotebookLM"
}

Response Time: 30-60 seconds

PowerShell Examples:

# Simple question
$body = @{
    question = "What are the main tips for parents?"
    notebook_id = "parents-numerique"
} | ConvertTo-Json

Invoke-RestMethod -Uri "http://localhost:3000/ask" -Method Post -Body $body -ContentType "application/json"

# With existing session
$body = @{
    question = "Follow-up question"
    session_id = "9a580eee"
} | ConvertTo-Json

Invoke-RestMethod -Uri "http://localhost:3000/ask" -Method Post -Body $body -ContentType "application/json"

3. Setup Auth

`POST /setup-auth`

Configure Google authentication (opens Chrome).

Request:

curl -X POST http://localhost:3000/setup-auth \
  -H "Content-Type: application/json" \
  -d '{
    "show_browser": true
  }'

Body Parameters:

Parameter	Type	Required	Description
`show_browser`	boolean	❌ No	Show Chrome (default: true)

Success Response (200):

{
  "success": true,
  "data": {
    "status": "success",
    "message": "Authentication setup completed successfully"
  }
}

4. List Notebooks

`GET /notebooks`

List all notebooks configured in the library.

Request:

curl http://localhost:3000/notebooks

Success Response (200):

{
  "success": true,
  "data": {
    "notebooks": [
      {
        "id": "parents-numerique",
        "name": "Parents and Digital",
        "description": "Advice for parents in the digital age",
        "url": "https://notebooklm.google.com/notebook/00000000-0000-0000-0000-000000000101",
        "topics": ["parenting", "digital", "education"],
        "use_cases": [
          "Educational advice in the digital age",
          "Questions about parenting and screens"
        ],
        "active": true
      }
    ],
    "count": 1
  }
}

5. Add Notebook

`POST /notebooks`

Add a new notebook to the library.

⚠️ Automatic validations:

✅ Checks NotebookLM URL format
✅ Validates that the notebook actually exists (live check)
✅ Blocks duplicate names
✅ Creates a temporary session to test access

Request:

curl -X POST http://localhost:3000/notebooks \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://notebooklm.google.com/notebook/00000000-0000-0000-0000-000000000101",
    "name": "Parents and Digital",
    "description": "Advice for parents in the digital age",
    "topics": ["parenting", "digital", "education"]
  }'

Body Parameters:

Parameter	Type	Required	Description
`url`	string	✅ Yes	NotebookLM notebook URL
`name`	string	✅ Yes	Notebook name (unique)
`description`	string	✅ Yes	Description
`topics`	string[]	✅ Yes	List of topics
`content_types`	string[]	❌ No	Content types (default: `["documentation", "examples"]`)
`use_cases`	string[]	❌ No	Use cases (auto-generated if absent)
`tags`	string[]	❌ No	Tags

Success Response (200):

{
  "success": true,
  "data": {
    "notebook": {
      "id": "parents-numerique",
      "name": "Parents and Digital",
      "description": "Advice for parents in the digital age",
      "url": "https://notebooklm.google.com/notebook/00000000-0000-0000-0000-000000000101",
      "topics": ["parenting", "digital", "education"],
      "content_types": ["documentation", "examples"],
      "use_cases": ["Educational advice", "Digital parenting"],
      "added_at": "2025-11-22T08:49:16.735Z",
      "last_used": "2025-11-22T08:49:16.735Z",
      "use_count": 0,
      "tags": [],
      "active": false
    }
  }
}

Possible Errors:

400 - Name already in use:

{
  "success": false,
  "error": "A notebook with the name 'Parents and Digital' already exists.\n\nExisting notebook ID: parents-numerique\nURL: https://notebooklm.google.com/notebook/00000000-0000-0000-0000-000000000101\n\nPlease use a different name, or update the existing notebook instead.\nTo update: PUT /notebooks/parents-numerique with new data\nTo delete: DELETE /notebooks/parents-numerique"
}

400 - Invalid URL:

{
  "success": false,
  "error": "Invalid NotebookLM URL: https://example.com\n\nExpected format: https://notebooklm.google.com/notebook/[notebook-id]\n\nExample: https://notebooklm.google.com/notebook/abc-123-def-456\n\nTo get the URL:\n1. Go to https://notebooklm.google.com\n2. Open your notebook\n3. Copy the URL from the address bar"
}

400 - Notebook inaccessible:

{
  "success": false,
  "error": "Invalid or inaccessible notebook.\n\nURL: https://notebooklm.google.com/notebook/invalid-id\n\nThe notebook page loaded but the chat interface was not found.\nThis usually means:\n- The notebook doesn't exist\n- You don't have access to this notebook\n- The notebook ID in the URL is incorrect\n\nPlease verify the URL by:\n1. Go to https://notebooklm.google.com\n2. Open the notebook manually\n3. Copy the exact URL from the address bar"
}

⏱️ Response Time: 15-30 seconds (live validation)

6. Auto-Discover Notebook

`POST /notebooks/auto-discover`

Automatically generate notebook metadata by querying NotebookLM itself.

Request:

{
  "url": "https://notebooklm.google.com/notebook/abc123"
}

Response (Success):

{
  "success": true,
  "notebook": {
    "id": "generated-uuid",
    "url": "https://notebooklm.google.com/notebook/abc123",
    "name": "auto-generated-notebook",
    "description": "Comprehensive guide covering key concepts. Includes practical exercises and examples.",
    "tags": ["topic1", "topic2", "learning", "examples", "exercises"],
    "auto_generated": true,
    "created_at": "2025-01-23T10:00:00Z"
  },
  "message": "Notebook auto-discovered and added to library"
}

Response (Error):

{
  "error": "NotebookLM returned invalid metadata format",
  "details": "Invalid name format: \"Invalid Name\". Must be kebab-case, 3 words max."
}

Errors:

400 Bad Request: Invalid URL format
404 Not Found: Notebook not accessible
500 Internal Server Error: NotebookLM query failed or returned invalid format
504 Gateway Timeout: NotebookLM query timeout (>30s)

How it works:

System opens the specified notebook
Sends prompt to NotebookLM asking it to analyze its own content
NotebookLM responds with JSON containing name, description, and tags
System validates the metadata format
Saves notebook to library with auto-generated metadata

Progressive Disclosure Pattern:

This endpoint enables the Level 0 of progressive disclosure:

Metadata stored locally (lightweight, ~100 bytes per notebook)
Loaded at startup for instant matching
Deep queries to NotebookLM only when notebook is selected

Orchestrators (Claude Code, n8n, Cursor) can scan all notebook metadata without rate limit concerns, then query NotebookLM only for the most relevant notebook.

6b. Create Notebook

`POST /notebooks/create`

Create a new empty notebook directly in NotebookLM.

Request:

curl -X POST http://localhost:3000/notebooks/create \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My New Notebook"
  }'

Body Parameters:

Parameter	Type	Required	Description
`name`	string	❌ No	Notebook name (auto-generated if not provided)
`show_browser`	boolean	❌ No	Show browser during creation

Success Response (200):

{
  "success": true,
  "data": {
    "notebook_url": "https://notebooklm.google.com/notebook/abc123-def456",
    "name": "My New Notebook"
  }
}

Note: This creates the notebook in NotebookLM but does NOT add it to the local library. Use POST /notebooks or POST /notebooks/auto-discover to add it to the library after creation.

7. Get Notebook

`GET /notebooks/:id`

Get details of a specific notebook.

Request:

curl http://localhost:3000/notebooks/parents-numerique

Success Response (200):

{
  "success": true,
  "data": {
    "notebook": {
      "id": "parents-numerique",
      "name": "Parents and Digital",
      "description": "Advice for parents in the digital age",
      "url": "https://notebooklm.google.com/notebook/00000000-0000-0000-0000-000000000101",
      "topics": ["parenting", "digital", "education"],
      "active": true
    }
  }
}

Error Response (404):

{
  "success": false,
  "error": "Notebook not found: parents-numerique"
}

8. Delete Notebook

`DELETE /notebooks/:id`

Delete a notebook from the library.

Request:

curl -X DELETE http://localhost:3000/notebooks/parents-numerique

Success Response (200):

{
  "success": true,
  "data": {
    "message": "Notebook removed successfully",
    "id": "parents-numerique"
  }
}

Error Response (404):

{
  "success": false,
  "error": "Notebook not found: parents-numerique"
}

Behavior:

If the deleted notebook was active, the first remaining notebook automatically becomes active
If it was the last notebook, active_notebook_id becomes null
Sessions using this notebook remain open but are no longer linked to a library notebook

9. Activate Notebook

`PUT /notebooks/:id/activate`

Set a notebook as active (default notebook for requests without notebook_id).

Request:

curl -X PUT http://localhost:3000/notebooks/shakespeare/activate

Success Response (200):

{
  "success": true,
  "data": {
    "message": "Notebook activated successfully",
    "notebook": {
      "id": "shakespeare",
      "name": "Shakespeare",
      "description": "William Shakespeare - Complete Works",
      "url": "https://notebooklm.google.com/notebook/00000000-0000-0000-0000-000000000102",
      "topics": ["literature", "theater", "Shakespeare"],
      "active": true,
      "last_used": "2025-11-22T10:30:45.123Z"
    }
  }
}

Error Response (404):

{
  "success": false,
  "error": "Notebook not found: shakespeare"
}

Behavior:

Updates last_used to current date/time
Sets active_notebook_id in library.json
Does not create a session (metadata only)

10. List Sessions

`GET /sessions`

List all active browser sessions.

Request:

curl http://localhost:3000/sessions

Success Response (200):

{
  "success": true,
  "data": {
    "sessions": [
      {
        "id": "session-00000001",
        "notebook_url": "https://notebooklm.google.com/notebook/xxx",
        "message_count": 3,
        "age_seconds": 245,
        "inactive_seconds": 120,
        "last_activity": 1763737756057
      }
    ],
    "count": 1,
    "max_sessions": 10
  }
}

11. Close Session

`DELETE /sessions/:id`

Close a specific browser session.

Request:

curl -X DELETE http://localhost:3000/sessions/9a580eee

Success Response (200):

{
  "success": true,
  "data": {
    "message": "Session closed successfully",
    "session_id": "9a580eee"
  }
}

Error Response (404):

{
  "success": false,
  "error": "Session not found: 9a580eee"
}

12. De-authenticate (Logout)

`POST /de-auth`

Logout by clearing all authentication data. Preserves notebook library.

Request:

curl -X POST http://localhost:3000/de-auth

Success Response (200):

{
  "success": true,
  "data": {
    "status": "de-authenticated",
    "message": "Successfully logged out. Use setup_auth or re_auth to authenticate again.",
    "authenticated": false
  }
}

Use cases:

Security logout before shutting down
Clearing credentials without re-authenticating
Removing access temporarily

13. Re-authenticate

`POST /re-auth`

Switch to a different Google account or re-authenticate after logout.

Request:

curl -X POST http://localhost:3000/re-auth \
  -H "Content-Type: application/json" \
  -d '{
    "show_browser": true
  }'

Body Parameters:

Parameter	Type	Required	Description
`show_browser`	boolean	❌ No	Show browser window (default: true)

Success Response (200):

{
  "success": true,
  "data": {
    "status": "authenticated",
    "message": "Successfully re-authenticated",
    "authenticated": true,
    "duration_seconds": 45.2
  }
}

Use cases:

Switching Google accounts
Recovery from rate limits (50 queries/day on free accounts)
Fresh authentication after errors

14. Cleanup Data

`POST /cleanup-data`

Deep cleanup of all NotebookLM MCP data files across 8 categories.

⚠️ CRITICAL: Close ALL Chrome/Chromium instances BEFORE running this!

Request:

# Preview first (confirm=false)
curl -X POST http://localhost:3000/cleanup-data \
  -H "Content-Type: application/json" \
  -d '{
    "confirm": false,
    "preserve_library": true
  }'

# Execute cleanup (confirm=true)
curl -X POST http://localhost:3000/cleanup-data \
  -H "Content-Type: application/json" \
  -d '{
    "confirm": true,
    "preserve_library": true
  }'

Body Parameters:

Parameter	Type	Required	Description
`confirm`	boolean	✅ Yes	Must be true to execute (false for preview)
`preserve_library`	boolean	❌ No	Keep library.json file (default: false)

Success Response (200):

{
  "success": true,
  "data": {
    "message": "Cleanup completed successfully",
    "files_deleted": 47,
    "space_freed_mb": 156.8,
    "library_preserved": true
  }
}

15. Update Notebook

`PUT /notebooks/:id`

Update notebook metadata (name, description, topics, etc.).

Request:

curl -X PUT http://localhost:3000/notebooks/n8n-workflows \
  -H "Content-Type: application/json" \
  -d '{
    "name": "n8n Advanced Workflows",
    "description": "Advanced n8n workflow patterns and best practices",
    "topics": ["n8n", "automation", "workflows", "advanced"]
  }'

Body Parameters:

Parameter	Type	Required	Description
`name`	string	❌ No	New notebook name
`description`	string	❌ No	New description
`topics`	string[]	❌ No	New topics array
`use_cases`	string[]	❌ No	New use cases array

Success Response (200):

{
  "success": true,
  "data": {
    "notebook": {
      "id": "n8n-workflows",
      "name": "n8n Advanced Workflows",
      "description": "Advanced n8n workflow patterns and best practices",
      "topics": ["n8n", "automation", "workflows", "advanced"],
      "last_modified": "2025-01-24T12:00:00.000Z"
    }
  }
}

16. Search Notebooks

`GET /notebooks/search?query=keyword`

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

Request:

curl "http://localhost:3000/notebooks/search?query=automation"

Query Parameters:

Parameter	Type	Required	Description
`query`	string	✅ Yes	Search keyword

Success Response (200):

{
  "success": true,
  "data": {
    "notebooks": [
      {
        "id": "n8n-workflows",
        "name": "n8n Advanced Workflows",
        "description": "Advanced n8n workflow patterns",
        "topics": ["n8n", "automation", "workflows"],
        "score": 0.95
      }
    ]
  }
}

17. Get Library Stats

`GET /notebooks/stats`

Get statistics about the notebook library.

Request:

curl http://localhost:3000/notebooks/stats

Success Response (200):

{
  "success": true,
  "data": {
    "total_notebooks": 5,
    "active_notebook_id": "n8n-workflows",
    "total_queries": 127,
    "most_used_notebook": {
      "id": "n8n-workflows",
      "name": "n8n Advanced Workflows",
      "use_count": 45
    },
    "recently_added": [
      {
        "id": "llm-dev",
        "name": "LLM Development",
        "added_at": "2025-01-24T10:00:00.000Z"
      }
    ]
  }
}

18. Reset Session

`POST /sessions/:id/reset`

Reset a session's chat history while keeping the same session ID.

Request:

curl -X POST http://localhost:3000/sessions/9a580eee/reset

Success Response (200):

{
  "success": true,
  "data": {
    "message": "Session reset successfully",
    "session_id": "9a580eee",
    "previous_message_count": 12
  }
}

Use cases:

Clean slate for new task without losing session context
Starting fresh conversation in same notebook

🔒 HTTP Error Codes

Code	Meaning	Description
`200`	OK	Successful request
`400`	Bad Request	Missing or invalid parameters
`401`	Unauthorized	Authentication required (if API key enabled)
`404`	Not Found	Resource not found
`500`	Internal Server Error	Server error
`503`	Service Unavailable	Server overloaded (too many sessions)

15. Add Source to Notebook

`POST /content/sources`

Add a document/source to a notebook. Supports multiple source types.

Request:

# Add URL source
curl -X POST http://localhost:3000/content/sources \
  -H "Content-Type: application/json" \
  -d '{
    "source_type": "url",
    "url": "https://example.com/article",
    "notebook_url": "https://notebooklm.google.com/notebook/abc123"
  }'

# Add text content
curl -X POST http://localhost:3000/content/sources \
  -H "Content-Type: application/json" \
  -d '{
    "source_type": "text",
    "text": "Your document content here...",
    "title": "My Document"
  }'

# Add YouTube video
curl -X POST http://localhost:3000/content/sources \
  -H "Content-Type: application/json" \
  -d '{
    "source_type": "youtube",
    "url": "https://www.youtube.com/watch?v=VIDEO_ID"
  }'

Body Parameters:

Parameter	Type	Required	Description
`source_type`	string	✅ Yes	Type: `file`, `url`, `text`, `youtube`, `google_drive`
`file_path`	string	❌ No	Local file path (for `file` type)
`url`	string	❌ No	URL (for `url`, `youtube`, `google_drive` types)
`text`	string	❌ No	Text content (for `text` type)
`title`	string	❌ No	Optional title for the source
`notebook_url`	string	❌ No	Target notebook URL
`session_id`	string	❌ No	Reuse existing session

Success Response (200):

{
  "success": true,
  "sourceName": "My Document",
  "status": "ready"
}

15b. Delete Source from Notebook

`DELETE /content/sources/:id`

Delete a source from a notebook by its ID.

Request:

curl -X DELETE "http://localhost:3000/content/sources/source-123?notebook_url=https://notebooklm.google.com/notebook/abc123"

Path Parameters:

Parameter	Type	Required	Description
`id`	string	Yes	The unique ID of the source

Query Parameters:

Parameter	Type	Required	Description
`notebook_url`	string	No	Target notebook URL
`session_id`	string	No	Reuse existing session

Success Response (200):

{
  "success": true,
  "data": {
    "success": true,
    "sourceId": "source-123",
    "sourceName": "My Document"
  }
}

Error Response (404):

{
  "success": false,
  "error": "Source not found: source-123"
}

`DELETE /content/sources` (Alternative)

Delete a source by name using query parameters. Useful when you know the source name but not the ID.

Request:

curl -X DELETE "http://localhost:3000/content/sources?source_name=My%20Document"

Query Parameters:

Parameter	Type	Required	Description
`source_id`	string	No*	The unique ID of the source
`source_name`	string	No*	The name of the source (partial match)
`notebook_url`	string	No	Target notebook URL
`session_id`	string	No	Reuse existing session

*At least one of source_id or source_name is required.

Success Response (200):

{
  "success": true,
  "data": {
    "success": true,
    "sourceId": "source-123",
    "sourceName": "My Document"
  }
}

Notes:

The source_name parameter supports partial matching (case-insensitive)
Use list_content first to find source IDs and names
This action is irreversible - the source will be permanently removed

16. Generate Content

`POST /content/generate`

Generate content using NotebookLM Studio features. Supports audio overview, video, infographic, report, presentation, and data table generation.

Note: v1.5.0 consolidated all content generation into this single endpoint.

Request:

# Generate a video (brief format)
curl -X POST http://localhost:3000/content/generate \
  -H "Content-Type: application/json" \
  -d '{
    "content_type": "video",
    "video_format": "brief",
    "video_style": "documentary",
    "language": "French",
    "custom_instructions": "Focus on key takeaways"
  }'

# Generate a presentation (detailed slideshow, short length)
curl -X POST http://localhost:3000/content/generate \
  -H "Content-Type: application/json" \
  -d '{
    "content_type": "presentation",
    "presentation_style": "detailed_slideshow",
    "presentation_length": "short",
    "language": "English"
  }'

# Generate a data table (exports to Google Sheets)
curl -X POST http://localhost:3000/content/generate \
  -H "Content-Type: application/json" \
  -d '{
    "content_type": "data_table",
    "language": "English"
  }'

Body Parameters:

Parameter	Type	Required	Description
`content_type`	string	✅ Yes	Type: `audio_overview`, `video`, `infographic`, `report`, `presentation`, `data_table`
`custom_instructions`	string	❌ No	Custom focus/prompt (not available for `report`)
`language`	string	❌ No	Output language (80+ supported)
`video_style`	string	❌ No	Visual style for video (see below)
`video_format`	string	❌ No	Video format: `brief` (default), `explainer`
`infographic_format`	string	❌ No	Infographic format: `horizontal` (default), `vertical`
`report_format`	string	❌ No	Report format: `summary` (default), `detailed`
`presentation_style`	string	❌ No	Style: `detailed_slideshow` (default), `presenter_notes`
`presentation_length`	string	❌ No	Length: `short`, `default`
`notebook_url`	string	❌ No	Target notebook URL
`session_id`	string	❌ No	Reuse existing session

Content Types and Export Options:

Content Type	Options	Custom Prompt	Export Type
`audio_overview`	language only	✅ Yes	WAV file
`video`	`brief`/`explainer` + 6 visual styles	✅ Yes	MP4 file
`infographic`	`horizontal`/`vertical`	✅ Yes	PNG file
`report`	`summary`/`detailed`	❌ No	Text (in response)
`presentation`	style + length options	✅ Yes	Google Slides
`data_table`	language only	✅ Yes	Google Sheets

Note: report does not support custom prompts - only format and language options are available.

Presentation Style Options:

Style	Description
`detailed_slideshow`	Full slides with visuals and content
`presenter_notes`	Slides with speaker notes

Presentation Length Options:

Length	Description
`short`	Condensed (5-8 slides)
`default`	Standard length (10-15)

Video Visual Styles:

Style	Description
`classroom`	Educational whiteboard style
`documentary`	Professional documentary style
`animated`	Motion graphics and animations
`corporate`	Business presentation style
`cinematic`	Film-quality dramatic style
`minimalist`	Clean, simple visuals

Success Response (200):

{
  "success": true,
  "data": {
    "success": true,
    "type": "video",
    "status": "ready",
    "message": "Video generated successfully"
  }
}

Note: Media generation can take several minutes. Use /content/download to retrieve files or export URLs.

17b. Download/Export Content

`GET /content/download`

Download or export generated content. Supports file downloads (audio, video, infographic) and Google exports (presentation, data_table).

Request:

# Download video file
curl "http://localhost:3000/content/download?content_type=video&output_path=/path/to/video.mp4"

# Download infographic
curl "http://localhost:3000/content/download?content_type=infographic&output_path=/path/to/image.png"

# Export presentation to Google Slides (returns URL)
curl "http://localhost:3000/content/download?content_type=presentation"

# Export data table to Google Sheets (returns URL)
curl "http://localhost:3000/content/download?content_type=data_table"

Query Parameters:

Parameter	Type	Required	Description
`content_type`	string	✅ Yes	Type: `audio_overview`, `video`, `infographic`, `presentation`, `data_table`
`output_path`	string	❌ No	Local path to save file (for downloadable types)
`notebook_url`	string	❌ No	Target notebook URL
`session_id`	string	❌ No	Reuse existing session

Export Types:

Content Type	Export Type	Output
`audio_overview`	File download	WAV file
`video`	File download	MP4 file
`infographic`	File download	PNG file
`presentation`	Google Slides	`googleSlidesUrl` in response
`data_table`	Google Sheets	`googleSheetsUrl` in response

Note: report is text-only and returned in the /content/generate response (no export option).

Success Response - File Download (200):

{
  "success": true,
  "data": {
    "success": true,
    "filePath": "/path/to/video.mp4",
    "mimeType": "video/mp4"
  }
}

Success Response - Google Slides Export (200):

{
  "success": true,
  "data": {
    "success": true,
    "googleSlidesUrl": "https://docs.google.com/presentation/d/abc123",
    "mimeType": "application/vnd.google-apps.presentation"
  }
}

Success Response - Google Sheets Export (200):

{
  "success": true,
  "data": {
    "success": true,
    "googleSheetsUrl": "https://docs.google.com/spreadsheets/d/xyz789",
    "mimeType": "application/vnd.google-apps.spreadsheet"
  }
}

Error Response (400):

{
  "success": false,
  "error": "Content type 'report' is not exportable. Report content is text-based and returned in the generation response."
}

18. List Content

`GET /content`

List all sources and generated content in a notebook.

Request:

curl "http://localhost:3000/content?notebook_url=https://notebooklm.google.com/notebook/abc123"

Query Parameters:

Parameter	Type	Required	Description
`notebook_url`	string	❌ No	Target notebook URL
`session_id`	string	❌ No	Reuse existing session

Success Response (200):

{
  "success": true,
  "sources": [
    {
      "id": "source-1",
      "name": "Introduction Document",
      "type": "document",
      "status": "ready"
    }
  ],
  "generatedContent": [
    {
      "id": "audio-overview",
      "type": "audio_overview",
      "name": "Audio Overview",
      "status": "ready",
      "createdAt": "2025-12-24T10:30:00Z"
    }
  ],
  "sourceCount": 3,
  "hasAudioOverview": true
}

19. Download/Export Content

`GET /content/download`

Download or export generated content from NotebookLM.

Request:

# Download audio
curl "http://localhost:3000/content/download?content_type=audio_overview&output_path=/path/to/audio.mp3"

# Download video
curl "http://localhost:3000/content/download?content_type=video&output_path=/path/to/video.mp4"

# Export presentation (returns Google Slides URL)
curl "http://localhost:3000/content/download?content_type=presentation"

# Export data table (returns Google Sheets URL)
curl "http://localhost:3000/content/download?content_type=data_table"

Query Parameters:

Parameter	Type	Required	Description
`content_type`	string	✅ Yes	Type: `audio_overview`, `video`, `infographic`, `presentation`, `data_table`
`output_path`	string	❌ No	Local path to save file (for audio, video, infographic)
`notebook_url`	string	❌ No	Target notebook URL
`session_id`	string	❌ No	Reuse existing session

Success Response - File Download (200):

{
  "success": true,
  "filePath": "/path/to/audio.mp3",
  "mimeType": "audio/mpeg",
  "size": 1234567
}

Success Response - Export (200):

{
  "success": true,
  "googleSlidesUrl": "https://docs.google.com/presentation/d/...",
  "googleSheetsUrl": "https://docs.google.com/spreadsheets/d/..."
}

Note: Report content is text-based and returned directly in the /content/generate response.

20. Create Note

`POST /content/notes`

Create a note in the NotebookLM Studio panel. Notes are user-created annotations that appear in your notebook alongside sources, allowing you to save research findings, summaries, key insights, or any custom content.

Request:

curl -X POST http://localhost:3000/content/notes \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Key Findings Summary",
    "content": "## Main Points\n\n1. First important finding\n2. Second key insight\n3. Conclusion and next steps"
  }'

Body Parameters:

Parameter	Type	Required	Description
`title`	string	✅ Yes	Title of the note
`content`	string	✅ Yes	Content/body of the note (supports markdown)
`notebook_url`	string	❌ No	Target notebook URL
`session_id`	string	❌ No	Reuse existing session

Success Response (200):

{
  "success": true,
  "data": {
    "success": true,
    "noteTitle": "Key Findings Summary",
    "status": "created"
  }
}

Error Response (400):

{
  "success": false,
  "error": "Missing required field: title"
}

Use Cases:

Save research summaries from NotebookLM conversations
Create custom annotations for specific sections
Store key quotes and references
Build a structured outline from notebook content

21. Save Chat to Note

`POST /content/chat-to-note`

Save the current chat discussion to a note. This captures the last response from NotebookLM and saves it as a note in the Studio panel.

Request:

curl -X POST http://localhost:3000/content/chat-to-note \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Summary of Key Points"
  }'

Body Parameters:

Parameter	Type	Required	Description
`title`	string	✅ Yes	Title for the saved note
`notebook_url`	string	❌ No	Target notebook URL
`session_id`	string	❌ No	Reuse existing session

Success Response (200):

{
  "success": true,
  "data": {
    "success": true,
    "noteTitle": "Summary of Key Points",
    "status": "saved"
  }
}

Use Cases:

Capture important NotebookLM responses for later reference
Build a collection of insights from multiple questions
Create study notes from Q&A sessions

22. Convert Note to Source

`POST /content/notes/:noteTitle/to-source`

Convert an existing note into a source. This makes the note content available as a citable source in the notebook.

Request:

curl -X POST "http://localhost:3000/content/notes/My%20Research%20Note/to-source" \
  -H "Content-Type: application/json" \
  -d '{}'

Path Parameters:

Parameter	Type	Required	Description
`noteTitle`	string	✅ Yes	URL-encoded title of the note

Body Parameters:

Parameter	Type	Required	Description
`notebook_url`	string	❌ No	Target notebook URL
`session_id`	string	❌ No	Reuse existing session

Success Response (200):

{
  "success": true,
  "data": {
    "success": true,
    "noteTitle": "My Research Note",
    "status": "converted"
  }
}

Error Response (404):

{
  "success": false,
  "error": "Note not found: My Research Note"
}

Use Cases:

Promote important notes to be citable sources
Include your own research as part of the notebook's knowledge base
Make aggregated insights available for citation in future responses

23. Scrape Notebooks from NotebookLM

`GET /notebooks/scrape`

Scrape all notebooks from the user's NotebookLM account.

Request:

curl "http://localhost:3000/notebooks/scrape?show_browser=true"

Query Parameters:

Parameter	Type	Description
`show_browser`	boolean	Show browser window for debug

Success Response (200):

{
  "success": true,
  "data": {
    "notebooks": [
      {
        "id": "00000000-0000-0000-0000-000000000103",
        "name": "Internal Family Systems",
        "url": "https://notebooklm.google.com/notebook/00000000-0000-0000-0000-000000000103"
      }
    ],
    "total": 16,
    "message": "Found 16 notebooks in NotebookLM account"
  }
}

24. Bulk Import Scraped Notebooks

`POST /notebooks/import-from-scrape`

Scrape notebooks from NotebookLM and bulk import them into the library.

Request:

curl -X POST http://localhost:3000/notebooks/import-from-scrape \
  -H "Content-Type: application/json" \
  -d '{"auto_discover": false}'

Body Parameters:

Parameter	Type	Required	Description
`notebook_ids`	string[]	No	Filter: only import these notebook IDs
`auto_discover`	boolean	No	Use AI to generate metadata (slower)
`show_browser`	boolean	No	Show browser window for debug

Success Response (200):

{
  "success": true,
  "data": {
    "imported": [
      {
        "id": "00000000-0000-0000-0000-000000000103",
        "name": "Internal Family Systems",
        "status": "imported"
      }
    ],
    "errors": [],
    "total_scraped": 16,
    "total_imported": 16,
    "total_errors": 0
  }
}

Use Cases:

Initial library setup: import all existing notebooks at once
Sync new notebooks: re-run to import newly created notebooks
Selective import: use notebook_ids to import specific notebooks only

📊 Limits and Quotas

Limit	Value	Configurable
Concurrent sessions	10	✅ Yes (`MAX_SESSIONS`)
Session timeout	15 min	✅ Yes (`SESSION_TIMEOUT`)
Request timeout	120 sec	❌ No (hardcoded)
Max question size	Unlimited	❌ No
NotebookLM rate limit	50/day	❌ No (Google limit)

🧪 Postman Collection

Import this collection:

{
  "info": {
    "name": "NotebookLM MCP API",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "item": [
    {
      "name": "Health Check",
      "request": {
        "method": "GET",
        "url": "http://localhost:3000/health"
      }
    },
    {
      "name": "Ask Question",
      "request": {
        "method": "POST",
        "url": "http://localhost:3000/ask",
        "header": [{ "key": "Content-Type", "value": "application/json" }],
        "body": {
          "mode": "raw",
          "raw": "{\"question\":\"What advice for parents?\",\"notebook_id\":\"parents-numerique\"}"
        }
      }
    }
  ]
}

Complete API Documentation! ✅

🌐 Base URL​

Available Endpoints (33 total)​

Authentication​

Queries​

Notebooks​

Sessions​

Content Management​

1. Health Check​

GET /health​

2. Ask Question​

POST /ask​

3. Setup Auth​

POST /setup-auth​

4. List Notebooks​

GET /notebooks​

5. Add Notebook​

POST /notebooks​

6. Auto-Discover Notebook​

POST /notebooks/auto-discover​

6b. Create Notebook​

POST /notebooks/create​

7. Get Notebook​

GET /notebooks/:id​

8. Delete Notebook​

DELETE /notebooks/:id​

9. Activate Notebook​

PUT /notebooks/:id/activate​

10. List Sessions​

GET /sessions​

11. Close Session​

DELETE /sessions/:id​

12. De-authenticate (Logout)​

POST /de-auth​

13. Re-authenticate​

POST /re-auth​

14. Cleanup Data​

POST /cleanup-data​

15. Update Notebook​

PUT /notebooks/:id​

16. Search Notebooks​

GET /notebooks/search?query=keyword​

17. Get Library Stats​

GET /notebooks/stats​

18. Reset Session​

POST /sessions/:id/reset​

🔒 HTTP Error Codes​

15. Add Source to Notebook​

POST /content/sources​

15b. Delete Source from Notebook​

DELETE /content/sources/:id​

DELETE /content/sources (Alternative)​

16. Generate Content​

POST /content/generate​

17b. Download/Export Content​

GET /content/download​

18. List Content​

GET /content​

19. Download/Export Content​

GET /content/download​

20. Create Note​

POST /content/notes​

21. Save Chat to Note​

POST /content/chat-to-note​

22. Convert Note to Source​

POST /content/notes/:noteTitle/to-source​

23. Scrape Notebooks from NotebookLM​

GET /notebooks/scrape​

24. Bulk Import Scraped Notebooks​

POST /notebooks/import-from-scrape​

📊 Limits and Quotas​

🧪 Postman Collection​

🌐 Base URL

Available Endpoints (33 total)

Authentication

Queries

Notebooks

Sessions

Content Management

1. Health Check

`GET /health`

2. Ask Question

`POST /ask`

3. Setup Auth

`POST /setup-auth`

4. List Notebooks

`GET /notebooks`

5. Add Notebook

`POST /notebooks`

6. Auto-Discover Notebook

`POST /notebooks/auto-discover`

6b. Create Notebook

`POST /notebooks/create`

7. Get Notebook

`GET /notebooks/:id`

8. Delete Notebook

`DELETE /notebooks/:id`

9. Activate Notebook

`PUT /notebooks/:id/activate`

10. List Sessions

`GET /sessions`

11. Close Session

`DELETE /sessions/:id`

12. De-authenticate (Logout)

`POST /de-auth`

13. Re-authenticate

`POST /re-auth`

14. Cleanup Data

`POST /cleanup-data`

15. Update Notebook

`PUT /notebooks/:id`

16. Search Notebooks

`GET /notebooks/search?query=keyword`

17. Get Library Stats

`GET /notebooks/stats`

18. Reset Session

`POST /sessions/:id/reset`

🔒 HTTP Error Codes

15. Add Source to Notebook

`POST /content/sources`

15b. Delete Source from Notebook

`DELETE /content/sources/:id`

`DELETE /content/sources` (Alternative)

16. Generate Content

`POST /content/generate`

17b. Download/Export Content

`GET /content/download`

18. List Content

`GET /content`

19. Download/Export Content

`GET /content/download`

20. Create Note

`POST /content/notes`

21. Save Chat to Note

`POST /content/chat-to-note`

22. Convert Note to Source

`POST /content/notes/:noteTitle/to-source`

23. Scrape Notebooks from NotebookLM

`GET /notebooks/scrape`

24. Bulk Import Scraped Notebooks

`POST /notebooks/import-from-scrape`

📊 Limits and Quotas

🧪 Postman Collection