zoom-dl
Enables downloading password-protected Zoom cloud recordings by emulating the Zoom web Unified Player authentication protocol to resolve signed CDN MP4 stream URLs, then transferring the video directly from the CDN. Provides tools to fetch recording metadata (topic, duration, file size, signed play URL) and to download the MP4 to a local path, with optional passcode support.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@zoom-dl download Zoom recording https://zoom.us/rec/share/abc123 password secret123"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Zoom-DL-MCP
Zoom Cloud Recording Downloader & Model Context Protocol (MCP) Server.
パスワード保護されたZoomクラウド録画から、ヘッドレスブラウザ(Selenium/Playwright)を用いずに直接MP4動画を抽出・ダウンロードするためのCLIツールおよびMCPサーバーです。Python標準ライブラリのみで実装されています。
概要
Zoomのウェブ版Unified Playerの認証通信をプロトコルレベルでエミュレートし、セッションCookieのハンドシェイクとパスコード認証APIを経て、署名付きCDNストリームURLを直接解決します。
外部依存パッケージなし(Python 3.8+ 標準ライブラリのみ)
ブラウザプロセス(Chromium等)の起動オーバーヘッドなし
署名付きCDN(AWS CloudFront)からの直接ストリーミング転送
MCP(Model Context Protocol)、CLI、Pythonモジュールに対応
Related MCP server: Zoom Recordings No-Auth
システム要件
Python 3.8 以上
インストール
git clone https://github.com/suim0kkin/Zoom-DL-MCP.git
cd Zoom-DL-MCP
pip install -e .※ インストールを行わず、リポジトリ内のスクリプトを直接実行することも可能です。
CLI の使用方法
基本構文
zoom-dl "<ZOOM_URL>" -p "<PASSCODE>"オプション
-p,--password: パスコード保護されている録画のパスワード。-o,--output: 保存先のファイルパスまたはディレクトリ(デフォルト:./downloads/<トピック名>.mp4)。--info-only: ダウンロードを実行せず、メタデータと署名付きCDN URLのみを表示。
実行例
# ダウンロード実行
zoom-dl "https://zoom.us/rec/share/..." -p "secret123" -o ./recordings/
# メタデータ確認のみ
zoom-dl "https://zoom.us/rec/share/..." -p "secret123" --info-onlyMCP サーバー設定
Claude Desktop、Antigravity、Cursor等のMCPクライアント設定ファイル(claude_desktop_config.json 等)に以下を追加します。
{
"mcpServers": {
"zoom-dl": {
"command": "python3",
"args": [
"/path/to/Zoom-DL-MCP/src/zoom_dl_mcp/server.py"
]
}
}
}提供ツール仕様
zoom_get_recording_info
引数:
url(string, 必須): Zoom録画の共有URL。password(string, 任意): 録画のパスコード。
返却値:
topic: 会議名 / トピック。duration_seconds: 録画時間(秒)。file_size_bytes: 動画ファイルサイズ(バイト)。play_url: 署名付きCDN MP4 URL。
zoom_download_recording
引数:
url(string, 必須): Zoom録画の共有URL。password(string, 任意): 録画のパスコード。output_path(string, 任意): 保存先ファイルパスまたはディレクトリ。
返却値:
saved_path: 保存完了したローカル絶対パス。file_size_bytes: 保存されたファイルサイズ。
Python API
from zoom_dl_mcp import ZoomRecordingClient
client = ZoomRecordingClient()
# メタデータの取得
metadata = client.fetch_recording_metadata(
share_url="https://zoom.us/rec/share/...",
password="secret_passcode"
)
print(f"Topic: {metadata.topic}")
print(f"Duration: {metadata.duration_seconds}s")
print(f"URL: {metadata.play_url}")
# ダウンロードの実行
saved_path = client.download_file(
metadata=metadata,
destination_path="./downloads/output.mp4"
)内部シーケンス
[Client] [Zoom Web] [Zoom CDN]
| | |
|-- 1. GET /rec/share/{id} --->| |
| (CookieJar初期化) | |
|<-- HTML (playInfoApi抽出) ---| |
| | |
|-- 2. GET playInfoApi ------->| |
|<-- middlePageInfo (認証要求) -| |
| | |
|-- 3. POST /verify-passcode ->| |
| {"passwd": "..."} | |
|<-- 200 OK (Cookie付与) ------| |
| | |
|-- 4. GET playInfoApi ------->| |
|<-- mediaInfo (playUrl解決) --| |
| |
|-- 5. GET playUrl (Range: bytes=0-0) -------------------->|
|<-- 206 Partial Content (サイズ確定) ---------------------|
| |
|-- 6. GET playUrl (ストリーム転送) ----------------------->|
|<-- 200/206 Binary Data (MP4) ----------------------------|テスト
python3 -m unittest discover -s testsライセンス
MIT License
Available Tools
2 toolszoom_download_recordingA
Downloads a Zoom cloud recording directly to local disk using reverse-engineered Unified Player session tokens without browser automation.
Inputs: url (required), password, output_path.
zoom_get_recording_infoA
Extracts metadata (topic, duration, file size, direct stream URL) from a public or password-protected Zoom cloud recording link.
Inputs: url (required), password.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 2 tools
The two tools target clearly different operations: metadata extraction versus actual file download. An agent can unambiguously choose between inspecting a recording link and downloading it, and the download tool even implies it may rely on info retrieved first.
Both names follow a strict `zoom_<verb>_<noun>` snake_case pattern with a consistent `zoom_` prefix. There is no mixing of conventions or vague verbs.
Two tools is thin even for a narrow single-purpose server, though both clearly earn their place. The surface feels minimal rather than over- or under-scoped for the stated task.
For the stated purpose of pulling a Zoom cloud recording from a link, the metadata-inspect and download pair covers the core workflow. Minor gaps exist, such as enumerating recordings within a meeting or selecting quality/format before download.
Maintenance
Related MCP Connectors
Create evidence-backed video clips from owned recordings through PrismClip's OAuth-connected MCP.
Memoket — access your recording transcripts, summaries, and key takeaways over MCP.
FFmpeg processing for video, audio and images via MCP with OAuth and shared account allowance.
Hosted MCP tools for FFmpeg-style video and audio processing through FFMPEG API.
Related MCP Servers
- AlicenseAqualityDmaintenanceAn MCP server that enables users to list, download, search, and manage Zoom meeting transcripts through a structured interface.610MIT
- AlicenseAqualityDmaintenanceA MCP server for accessing Zoom recordings and transcripts without requiring direct authentication from the end user.49 npm9Apache 2.0
- AlicenseNot gradedqualityDmaintenanceEnables users to list and manage Zoom cloud recordings through the Model Context Protocol. It allows for searching recordings by date and retrieving specific meeting details, including download URLs for video, audio, and transcripts.MIT
- AlicenseNot gradedqualityDmaintenanceEnables interaction with Zoom APIs through MCP, supporting multi-user OAuth token management, read-only and admin-gated mutation tools, schema discovery, and query suggestions for LLM workflows.MIT