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 is the result of an AuthHealthChecker probe. The checker runs a multi-probe strategy (homepage fetch + API fallback) with 30-second TTL caching and mtime-based bypass on auth-file changes. The reported value may therefore be up to 30 seconds old, and an external nlm login is picked up within one check cycle without waiting for the TTL to expire.

auth_status meanings:

• "configured" — homepage (or API fallback) check passed; credentials are good. Cached credentials may be reported as configured for up to 30 seconds.

• "not_configured" — no credentials are stored (first-time setup).

• "stale" — credentials are known-bad (expired or past the 7-day heuristic). Operations will fail; ask the user to run nlm login to refresh.

• "unverified" — the check could not be completed (network error, timeout, non-200 response). Cached credentials may still work for actual API calls, so do not assume the user needs to re-auth.

• "error" — unexpected exception inside the check itself.

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 is available - auth_status: configured | stale | unverified | 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