Reload auth tokens from disk or run headless re-authentication.

Call this after running nlm login to pick up new tokens, or to attempt automatic re-authentication if Chrome profile has saved login.

Returns status indicating if tokens were refreshed successfully.

Save NotebookLM cookies (FALLBACK method - try nlm login first!).

IMPORTANT FOR AI ASSISTANTS:

• First, run nlm login via Bash/terminal (automated, preferred)

• Only use this tool if the automated CLI fails

Perform batch operations across multiple notebooks.

Actions:

• query: Query multiple notebooks with the same question

• add_source: Add the same source URL to multiple notebooks

• create: Create multiple notebooks at once

• delete: Delete multiple notebooks (IRREVERSIBLE, requires confirm=True)

• studio: Generate studio artifacts across multiple notebooks

Ask AI about EXISTING sources already in notebook. NOT for finding new sources.

Use research_start instead for: deep research, web search, find new sources, Drive search.

Configure notebook chat settings.

Start a notebook query asynchronously for large notebooks that may timeout.

Use this instead of notebook_query when querying notebooks with many sources (50+) where the response may take longer than 60 seconds. Returns immediately with a query_id. Poll notebook_query_status with the query_id to get the result.

Workflow: notebook_query_start -> poll notebook_query_status until completed.

Check the status of an async notebook query started with notebook_query_start.

Returns the query result when completed, or current status if still in progress. Poll this tool every few seconds until status is 'completed' or 'error'.

Query multiple notebooks and get aggregated answers with per-notebook citations.

Specify notebooks by name, by tags, or use all=True for all notebooks.

Download any NotebookLM artifact to a file.

Unified download tool replacing 9 separate download tools. Supports all artifact types: audio, video, report, mind_map, slide_deck, infographic, data_table, quiz, flashcards.

Export a NotebookLM artifact to Google Docs or Sheets.

Supports:

• Data Tables → Google Sheets

• Reports (Briefing Doc, Study Guide, Blog Post) → Google Docs

List all notebooks.

Get notebook details with sources.

Get AI-generated notebook summary with suggested topics.

Create a new notebook.

Rename a notebook.

Delete notebook permanently. IRREVERSIBLE. Requires confirm=True.

Manage notes in a notebook. Unified tool for all note operations.

Supports: create, list, update, delete

Manage and execute multi-step notebook pipelines.

Actions:

• run: Execute a pipeline on a notebook

• list: List all available pipelines (builtin and user-defined)

Deep research / fast research: Search web or Google Drive to FIND NEW sources.

Use this for: "deep research on X", "find sources about Y", "search web for Z", "search Drive". Workflow: research_start -> poll research_status -> research_import.

Poll research progress. Blocks until complete or timeout.

Import discovered sources into notebook.

Call after research_status shows status="completed".

Get server version, check for updates, and report auth status.

AI assistants: If update_available is True, inform the user that a new version is available and suggest updating with the provided command.

auth_status now performs a best-effort live validation against NotebookLM (same mechanism as nlm login --check) when tokens exist. This makes the reported status consistent with actual usability instead of relying only on a local age heuristic.

Returns: dict with version info: - version: Current installed version - latest_version: Latest version on PyPI (or None if check failed) - update_available: True if a newer version exists - auth_status: configured | stale | not_configured | error - update_command: Command to run to update

Get current sharing settings and collaborators.

Enable or disable public link access.

Invite a collaborator by email.

Invite multiple collaborators in a single request.

Manage notebook tags and find relevant notebooks by tag matching.

Actions:

• add: Add tags to a notebook for smart selection

• remove: Remove tags from a notebook

• list: List all tagged notebooks with their tags

• select: Find notebooks relevant to a query using tag matching

Add a source to a notebook. Unified tool for all source types.

Supports: url, text, drive, file

List sources with types and Drive freshness status.

Use before source_sync_drive to identify stale sources.

Sync Drive sources with latest content. Requires confirm=True.

Call source_list_drive first to identify stale sources.

Rename a source in a notebook.

Delete source(s) permanently. IRREVERSIBLE. Requires confirm=True.

Get AI-generated source summary with keyword chips.

Get raw text content of a source (no AI processing).

Returns the original indexed text from PDFs, web pages, pasted text, or YouTube transcripts. Much faster than notebook_query for content export.

Create any NotebookLM studio artifact. Unified creation tool.

Supports: audio, video, infographic, slide_deck, report, flashcards, quiz, data_table, mind_map

Check studio content generation status and get URLs, or rename an artifact.

Delete studio artifact. IRREVERSIBLE. Requires confirm=True.

Revise individual slides in an existing slide deck. Creates a NEW artifact.

Only slide decks support revision. The original artifact is not modified. Poll studio_status after calling to check when the new deck is ready.

Manage source labels in a notebook. Unified tool for all label operations.

Labels let you organize sources into thematic categories. Requires 5+ sources for auto-labeling. Sources can belong to multiple labels simultaneously.

Supports: auto, list, reorganize, create, rename, set_emoji, move_source, delete