glebis/zoom

Zoom Skill

Manage Zoom meetings and cloud recordings via the Zoom API.

Features

• Meetings: List, create, update, delete scheduled meetings
• Recordings: List cloud recordings with transcripts, summaries, and download links

Note: All times passed to create/update commands are interpreted as local time. The script auto-detects your timezone if not explicitly specified with --timezone.

Prerequisites

This skill uses two authentication methods:

| Feature | Auth Type | Credentials File | |---------|-----------|------------------| | Meetings | Server-to-Server OAuth | ~/.zoom_credentials/credentials.json | | Recordings | User OAuth (General App) | ~/.zoom_credentials/oauth_token.json |

Check status:

python3 scripts/zoom_meetings.py setup

Setup

Part 1: Server-to-Server OAuth (for Meetings)

1. Go to marketplace.zoom.us → Develop → Build App
2. Select Server-to-Server OAuth
3. Name it (e.g., "Claude Zoom Meetings")
4. Copy Account ID, Client ID, Client Secret
5. Add scopes:
   • meeting:read:meeting:admin
   • meeting:read:list_meetings:admin
   • meeting:write:meeting:admin
   • user:read:user:admin
6. Activate the app
7. Save credentials:

mkdir -p ~/.zoom_credentials
cat > ~/.zoom_credentials/credentials.json << 'EOF'
{
  "account_id": "YOUR_ACCOUNT_ID",
  "client_id": "YOUR_CLIENT_ID",
  "client_secret": "YOUR_CLIENT_SECRET"
}
EOF

Part 2: General App OAuth (for Recordings)

Server-to-Server apps cannot access cloud recordings. You need a separate General App:

1. Go to marketplace.zoom.us → Develop → Build App
2. Select General App
3. Set redirect URL: http://localhost:8888/callback
4. Copy Client ID and Client Secret
5. Add scopes:
   • cloud_recording:read:list_user_recordings
   • cloud_recording:read:list_recording_files
6. Activate the app
7. Authorize (one-time browser flow):

# Open this URL in browser (replace CLIENT_ID):
https://zoom.us/oauth/authorize?response_type=code&client_id=YOUR_CLIENT_ID&redirect_uri=http://localhost:8888/callback

# After authorizing, you'll be redirected to:
# http://localhost:8888/callback?code=AUTHORIZATION_CODE

# Exchange the code for tokens (replace values):
python3 -c "
import requests, json
resp = requests.post('https://zoom.us/oauth/token',
    auth=('CLIENT_ID', 'CLIENT_SECRET'),
    data={'grant_type': 'authorization_code', 'code': 'AUTH_CODE', 'redirect_uri': 'http://localhost:8888/callback'})
data = resp.json()
data['client_id'] = 'CLIENT_ID'
data['client_secret'] = 'CLIENT_SECRET'
data['expires_at'] = __import__('time').time() + data.get('expires_in', 3600)
with open(__import__('pathlib').Path.home() / '.zoom_credentials/oauth_token.json', 'w') as f:
    json.dump(data, f, indent=2)
print('Saved!')
"

Quick Start

# Check setup
python3 scripts/zoom_meetings.py setup

# List upcoming meetings
python3 scripts/zoom_meetings.py list

# Create a meeting
python3 scripts/zoom_meetings.py create "Team Standup" --start "2025-01-15T10:00:00" --duration 30

# List recordings
python3 scripts/zoom_meetings.py recordings --start 2025-01-01

Commands

Meetings

# List meetings
python3 scripts/zoom_meetings.py list                      # upcoming
python3 scripts/zoom_meetings.py list --type previous      # past
python3 scripts/zoom_meetings.py list --limit 10 --json

# Get meeting details
python3 scripts/zoom_meetings.py get MEETING_ID

# Create meeting (times are treated as LOCAL time)
python3 scripts/zoom_meetings.py create "Topic"                              # instant
python3 scripts/zoom_meetings.py create "Topic" --start "2025-01-15T14:00:00" # scheduled (local time)
python3 scripts/zoom_meetings.py create "Topic" --duration 60 --timezone "Europe/Berlin"
python3 scripts/zoom_meetings.py create "Topic" --agenda "Discussion points" --waiting-room
python3 scripts/zoom_meetings.py create "Topic" --invite "[email protected]"  # send invite
python3 scripts/zoom_meetings.py create "Topic" --invite "[email protected]" --invite "[email protected]"  # multiple

# Update meeting
python3 scripts/zoom_meetings.py update MEETING_ID --topic "New Topic"
python3 scripts/zoom_meetings.py update MEETING_ID --start "2025-01-16T10:00:00"

# Delete meeting (requires meeting:delete:meeting:admin scope)
python3 scripts/zoom_meetings.py delete MEETING_ID

Recordings

# List all recordings (default: last 30 days)
python3 scripts/zoom_meetings.py recordings

# With date range
python3 scripts/zoom_meetings.py recordings --start 2025-01-01 --end 2025-01-31

# Show download URLs
python3 scripts/zoom_meetings.py recordings --show-downloads

# Get specific meeting's recordings
python3 scripts/zoom_meetings.py recording MEETING_ID

# JSON output
python3 scripts/zoom_meetings.py recordings --json

Output Formats

Markdown (default)

# Zoom Meetings (3 upcoming)

## Weekly Team Sync
**ID:** 123456789
**Start:** 2025-01-15 14:00:00 UTC
**Duration:** 60 minutes
**Join URL:** https://zoom.us/j/123456789

JSON

Add --json for structured output suitable for piping to other tools.

Recording File Types

| Type | Description | |------|-------------| | MP4 | Video recording | | M4A | Audio only | | TRANSCRIPT | Text transcript (VTT) | | CHAT | Chat messages | | TIMELINE | Speaker timeline | | SUMMARY | AI meeting summary |

Example User Requests

| User says | Command | |-----------|---------| | "List my Zoom meetings" | list | | "Show past meetings" | list --type previous | | "Create a meeting for tomorrow at 2pm" | create "Meeting" --start "2025-01-15T14:00:00" | | "Show my Zoom recordings" | recordings --start 2025-01-01 | | "Get the recording for meeting X" | recording MEETING_ID |

Dependencies

pip install requests

Files

| File | Purpose | |------|---------| | ~/.zoom_credentials/credentials.json | S2S OAuth credentials | | ~/.zoom_credentials/token.json | S2S cached token | | ~/.zoom_credentials/oauth_token.json | User OAuth tokens (auto-refreshes) |

Known Pitfalls

• join_before_host is account-level. This setting is locked at the Zoom account admin level. Setting it via API per-meeting is silently ignored if the account setting overrides it. Must change in Zoom admin settings (Security → "Allow participants to join before host") first, then API calls respect it.
• Waiting room overrides join-before-host. If waiting room is enabled at account level, join_before_host won't work even if the API accepts it.

API Reference

• Zoom Meeting APIs
• Zoom API Reference