Zoom Recording Downloader

🚀 Zoom Meeting Recording Download Tool

A Python tool for downloading Zoom meeting recording files, supporting both command-line and MCP server usage.

🚀 Quick Start

This tool is designed to download Zoom meeting recordings. It supports two usage modes: command-line and MCP server.

✨ Features

• Retrieve a list of all meeting recordings within a specified date range.
• Download meeting recording files in batches to the local machine.
• Automatically create a directory structure based on the meeting topic and time.
• Support resume interrupted downloads (by detecting the size of downloaded files).
• Support MCP server mode, which can be integrated into Claude Code.
• Support configuration via environment variables and command-line parameters.

📦 Project Structure

zoom/
├── download_zoom_recordings.py  # Main download script
├── zoom_utils.py                # Utility function module
├── mcp_server.py                # MCP server implementation
├── requirements.txt             # Python dependencies
├── recordings.json              # Meeting list data (automatically generated)
├── downloads/                   # Download directory (automatically created)
└── README.md                    # Documentation

📦 Installation

pip install -r requirements.txt

📚 Configuration

Method 1: Use the .env file (Recommended)

Create a .env file and add the following configuration:

ZOOM_AUTH=your_authorization_token
ZOOM_CSRFTOKEN=your_zoom_csrftoken
ZOOM_COOKIES=your_browser_cookies

Method 2: Command-line parameters

Pass authentication information directly through the command line.

📚 Obtain Authentication Information

1. Log in to the Zoom web version (https://thoughtworks.zoom.us/recording/).
2. Open the browser developer tools (F12).
3. Switch to the Network tab.
4. Refresh the page and click on any request.
5. Copy the following values from the request headers:
   • Authorization value
   • zoom-csrftoken value
6. Copy all cookies from Application > Cookies.

💻 Usage Examples

Command-line Mode

1. Download all recordings

python download_zoom_recordings.py

2. Specify a date range

python download_zoom_recordings.py -s "01/01/2024" -e "12/31/2024"

3. Specify the download directory

python download_zoom_recordings.py -d /path/to/downloads

4. Pass authentication information

python download_zoom_recordings.py -a "your_auth_token" -t "your_csrftoken" -c "your_cookies"

Complete parameter description

MCP Server Mode

Start the MCP server

python mcp_server.py

The MCP server will expose the download_recordings tool, which can be used in Claude Code.

Claude Code Configuration

Add the following to .mcp.json:

{
  "mcpServers": {
    "zoom-download": {
      "command": "python",
      "args": ["/path/to/mcp_server.py"],
      "env": {}
    }
  }
}

📚 File Structure

The downloaded files will be automatically organized in the following structure:

downloads/
└── Meeting_Topic_20240101_143000/
    ├── file_1.mp4
    ├── file_2.mp4
    └── ...

📚 API Documentation

ZoomRecordingDownloader Class

Main methods:

• get_meeting_list() - Get a single-page meeting list.
• get_all_recordings() - Get information about all meeting recordings.
• save_recordings_to_json() - Save recording information to JSON.
• get_download_file_list() - Get the download file list for a single meeting.
• download_file() - Download a single file.
• download_meeting_recordings() - Download all recordings for a single meeting.
• download_all() - Download all recordings in batches.

zoom_utils Module

A pure function utility module that provides:

• extract_filename_from_url() - Extract the file name from a URL.
• build_meeting_dir_name() - Build the meeting directory name.
• parse_cookies_string() - Parse the cookies string.
• ensure_directory_exists() - Ensure that the directory exists.
• extract_recordings_from_response() - Extract the recording list from the API response.
• extract_download_urls_from_response() - Extract the download URLs from the response.

⚠️ Important Note

1. Authentication information expiration: Authentication information may expire periodically and needs to be re-obtained.
2. Request frequency: The tool has a built-in 1-second request interval to avoid triggering Zoom's rate limit.
3. File size: Large recording files may take a long time to download.
4. Storage space: Ensure that there is enough disk space to store the downloaded files.
5. Cookies format reference: _zm_mtk_guid=xx; _zm_visitor_guid=xx; ..

📄 License

MIT License