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:

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!')
"