Install the NotebookLM CLI:

uv tool install notebooklm-mcp-cli
# OR
pip install notebooklm-mcp-cli

Authenticate:
```
nlm login
```

Install epub2txt (for .epub support): The skill expects epub2txt to be installed in your programs directory. Clone and initialize it using the following commands:

mkdir -p ~/Programs
cd ~/Programs
git clone https://github.com/SPACESODA/epub2txt.git
cd epub2txt
chmod +x run.sh
./run.sh  # This initializes the virtual environment

Workflow

When activated, follow these steps strictly in order. Do not skip steps.

Step 1: Gather Information

Ask the user for the following information one by one to prepare for the generation:

Ask for a desired name for the new notebook. If not provided, use the default name "Audio Overview Notebook".
Source Selection: Ask the user to select their sources from the following options:
- Local Files: .pdf, .txt, and .epub (which will be automatically converted). Use GUI pickers:
  - macOS: osascript -e "set theFiles to choose file with prompt \"Select your source file(s):\" multiple selections allowed true" ...
  - Linux: zenity --file-selection --multiple ...
  - Windows: PowerShell OpenFileDialog.
- Web/Video URLs: Ask the user to provide any website or YouTube URLs.
- Google Drive: Ask for Google Drive Document IDs.
Preferred Language: Ask the user for the preferred output language (BCP-47 code).
- Options: Provide common choices: en (English - default), zh (Chinese), ja (Japanese), es (Spanish), fr (French), de (German).
Download Destination: Use a GUI directory picker to select where the audio file should be saved.

Crucial: Ask the user interactively to confirm they have provided/selected all the sources they wish to include before proceeding.

Step 2: Create a New Notebook

Use the notebook_create tool to create a new notebook with the provided name. Keep track of the notebook_id.

Step 3: Upload Sources

Loop through all gathered sources:
- EPUB Files: Convert to .txt first: cd ~/Programs/epub2txt && ./run.sh "<path>". Use the new .txt path.
- Other Files: Use source_add(source_type="file", file_path="...").
- URLs/YouTube: Use source_add(source_type="url", url="...").
- Drive: Use source_add(source_type="drive", document_id="...").
Always set wait=true to ensure sources are processed.

Step 4: Generate Audio Overview

Use the studio_create tool to start the audio generation.
- Set notebook_id to the ID.
- Set artifact_type to audio.
- Set audio_format to deep_dive.
- Set audio_length to long.
- Language: Use the user's selected BCP-47 code (e.g., zh).
- Custom Prompt: If the selected language is NOT English (en), you MUST provide the following focus_prompt to encourage a longer, more detailed output:
  
  "Please provide an extremely detailed deep dive. Analyze each source file thoroughly without omitting any details. The conversation should be as long as possible, aiming for over 40 minutes."
- Set confirm to true.

Step 5: Monitor Generation Status

Inform the user: Explicitly tell the user that generating a long, deep-dive audio overview can take 5 to 15 minutes.
Use the studio_status tool with action: status in a polling loop (using run_shell_command with sleep 300 between checks) until the status becomes completed.
Note the audio_url and artifact_id when finished. Crucial: If there are multiple audio artifacts returned in the status, always identify and note the latest one (the one with the most recent created_at timestamp).

Step 6: Download the Audio

Using the artifact_id of the latest audio, try using the download_artifact tool first to save the audio to the destination path with an .mp3 extension.

Step 7: Final Verification

Verify the downloaded file using file <output_path>.
Inform the user that the process is complete.

notebooklm-audio-generator

NotebookLM Audio Generator Skill

Prerequisites

Installation & Setup