loom-dl Video Downloader

You can run loom-dl as a Model Context Protocol (MCP) server to allow AI assistants (like Cursor or Claude Desktop) to download Loom videos.

Setup Add the following to your MCP configuration (e.g., claude_desktop_config.json):

{
  "mcpServers": {
    "loom-downloader": {
      "command": "npx",
      "args": ["-y", "loom-dl@latest", "--mcp"]
    }
  }
}

Exposed Tools

• download_loom_video: Downloads a video. Supports options: output_dir, with_transcript, with_image, with_gif, with_seek_preview.
• get_loom_video_info: Retrieves metadata (title, duration, transcript availability) without downloading.

To download multiple videos at once, create a text file containing one Loom URL per line, then use the --list (or -l) flag.

Batch Options

• --prefix (-p): Add a custom prefix to all filenames in the batch.
• --out (-o): Specify the output directory for all downloaded files.
• --timeout (-t): Add a delay (in milliseconds) between downloads to avoid rate limiting/blocking.

# 1. Create urls.txt with one URL per line
# 2. Run batch download with prefix and output directory
loom-dl --list urls.txt --prefix "tutorial" --out ./downloads

# 3. Run batch download with a 5-second delay between videos
loom-dl --list urls.txt --timeout 5000

You can install the Loom Video Downloader globally via npm or by cloning the repository.

Prerequisites

• Node.js 12.0.0 or higher

Option 1: Global Installation (Recommended)

npm install -g loom-dl

Option 2: Clone Repository

git clone https://github.com/EcomGraduates/loom-downloader.git
cd loom-downloader
npm install

Use the --url (or -u) flag to download a specific video. By default, the video is saved using its ID as the filename in your Downloads folder.

Custom Filename/Path You can specify a custom filename or a full path using the --out (or -o) flag.

# Basic download
loom-dl --url https://www.loom.com/share/abc123def456

# Custom filename
loom-dl --url https://www.loom.com/share/abc123def456 --out my-video.mp4

# Custom path and filename
loom-dl --url https://www.loom.com/share/abc123def456 --out path/to/my-video.mp4

You can persist your preferred settings by using the --save-config flag. This saves the current command-line options into a .loomrc.json file in the project directory.

Available configuration keys include:

• quality: Video quality preference (auto, 480p, 720p, 1080p, best)
• resume: Whether to resume incomplete downloads (boolean)
• timeout: Delay (ms) between batch downloads
• outputDir: Default directory for downloads
• prefix: Prefix for filenames in batch mode
• transcript: Whether to download transcripts by default (boolean)

# Save current quality and output directory as defaults
node loom-dl.js --quality 1080p --out ./my-videos --save-config

# View current configuration
node loom-dl.js --show-config

# Reset configuration to defaults
node loom-dl.js --reset-config

Use the --url (or -u) flag to download a specific Loom video. By default, the video is saved using its ID as the filename in the current directory. You can use --use-title to name the file after the video's title instead.

# Download a single video
node loom-dl.js --url https://www.loom.com/share/VIDEO_ID

# Download a single video using its title as the filename
node loom-dl.js --url https://www.loom.com/share/VIDEO_ID --use-title

To download multiple videos at once, provide a path to a text file containing one Loom URL per line using the --list (or -l) flag. The tool will process the list and skip any URLs that have already been recorded in downloaded.log.

# Download all videos listed in urls.txt
node loom-dl.js --list urls.txt

In addition to the video, you can request several metadata and asset files using these flags:

• --transcript: Download the transcript as a .transcript.json file.
• --transcript-only: Download only the transcript and skip the video file.
• --image: Download the video thumbnail as a .jpg.
• --gif: Download the video thumbnail as a .gif.
• --seek-preview: Download the seek preview sprite image (.jpg) and the corresponding .vtt file used for scrubber thumbnails.

# Download video, transcript, thumbnail, and seek previews
node loom-dl.js --url https://www.loom.com/share/ID --transcript --image --seek-preview