AI agent skill · by @antoniolg

Zoom Recordings Manager

List, download, and delete Zoom recordings via the API (OAuth). Use when you need to manage recordings at scale.

Archived 2026-10-23 · Source updated 2026-05-18. Check the original repository for the latest version.

SKILL.md instructions

# Zoom recordings manager

## Goal
Generic operations on recordings:
- list
- download
- delete (by meeting or by file)

## Requirements
- Zoom OAuth credentials (Server-to-Server recommended)
- Environment variables:
  - ZOOM_ACCOUNT_ID
  - ZOOM_CLIENT_ID
  - ZOOM_CLIENT_SECRET

## Key notes
- Recurring meetings: use the **meeting UUID** for a specific instance.
- Deletion: use `trash` by default; `delete` is permanent.
- Downloads: use `download_url` and add the access_token.

## Quick script
File: `scripts/zoom_recordings.py`

List:
```
python scripts/zoom_recordings.py list --from 2025-11-01 --to 2025-12-31
```

List upcoming meetings (join_url for attendees):
```
python scripts/zoom_meetings.py --user me --type upcoming --from 2026-01-14 --to 2026-03-31
```

List by user:
```
python scripts/zoom_recordings.py list --user me --from 2025-11-01 --to 2025-12-31
```

Download:
```
python scripts/zoom_recordings.py download --url "<download_url>" --out /path/file.mp4
```

Download MP4 of LIVE/Q&A (renamed):
```
python scripts/zoom_recordings.py download-mp4 --user me --from 2025-11-01 --to 2025-12-31 --out-dir /path/zoom
```

Delete (entire meeting):
```
python scripts/zoom_recordings.py delete --meeting-id <meeting_id> --action trash
```

Delete a specific file:
```
python scripts/zoom_recordings.py delete --meeting-id <meeting_id> --recording-id <recording_id> --action trash
```

## If it fails
- Verify scopes (recording:read / recording:write) in the OAuth app.
- If the account endpoint fails, use `--user`.
- Zoom limits listings to ~30-day windows; the script already chunks requests.