zoom-cli

A command-line interface for the Zoom API -- manage meetings, recordings, users, webinars, and reports from your terminal.

Install

# From crates.io
cargo install zoom-cli

# From PyPI (pre-built binaries, no Rust toolchain needed)
pip install zoom-cli

# From GitHub Releases (Linux, macOS)
curl -fsSL https://github.com/rvben/zoom-cli/releases/latest/download/zoom-$(uname -m)-unknown-linux-gnu.tar.gz | tar xz

Quick Start

# Interactive setup (creates config with your Zoom OAuth credentials)
zoom init

# List your upcoming meetings
zoom meetings list

# Create a meeting
zoom meetings create --topic "Standup" --duration 30

# List cloud recordings from a date range
zoom recordings list --from 2026-01-01

# Get current user info
zoom users me

Configuration

Config file

~/.config/zoom-cli/config.toml

[default]
account_id = "YOUR_ACCOUNT_ID"
client_id = "YOUR_CLIENT_ID"
client_secret = "YOUR_CLIENT_SECRET"

[work]
account_id = "..."
client_id = "..."
client_secret = "..."

Requires a Zoom Server-to-Server OAuth app.

Environment variables

Variable	Description
`ZOOM_ACCOUNT_ID`	OAuth account ID
`ZOOM_CLIENT_ID`	OAuth client ID
`ZOOM_CLIENT_SECRET`	OAuth client secret
`ZOOM_PROFILE`	Active profile name (default: `default`)

Precedence

CLI flags > environment variables > config file

Commands

Meetings

Command	Description
`zoom meetings list [--user <id>] [--type <t>]`	List meetings for a user
`zoom meetings get <id>`	Get meeting details
`zoom meetings create --topic <t> [--duration <m>] [--start <dt>] [--password <p>]`	Create a meeting
`zoom meetings update <id> [--topic <t>] [--duration <m>] [--start <dt>]`	Update a meeting
`zoom meetings delete <id>`	Delete a meeting
`zoom meetings end <id>`	End a live meeting
`zoom meetings participants <id>`	List past meeting participants
`zoom meetings invite <id>`	Get meeting invitation text

Recordings

Command	Description
`zoom recordings list [--user <id>] [--from <date>] [--to <date>]`	List cloud recordings
`zoom recordings get <meeting_id>`	Get recording details
`zoom recordings download <meeting_id> [--out <dir>]`	Download recording files
`zoom recordings delete <meeting_id> [--permanent]`	Delete cloud recordings
`zoom recordings start <meeting_id>`	Start recording a live meeting
`zoom recordings stop <meeting_id>`	Stop recording
`zoom recordings pause <meeting_id>`	Pause recording
`zoom recordings resume <meeting_id>`	Resume recording
`zoom recordings transcript <meeting_id> [--out <dir>]`	Download transcript files

Users

Command	Description
`zoom users list [--status <s>]`	List account users
`zoom users get <id_or_email>`	Get user details
`zoom users me`	Get current user
`zoom users create --email <e> [--first-name <n>] [--last-name <n>] [--type <t>]`	Create a user
`zoom users deactivate <id_or_email>`	Deactivate a user
`zoom users activate <id_or_email>`	Reactivate a user

Webinars

Command	Description
`zoom webinars list [--user <id>]`	List webinars
`zoom webinars get <id>`	Get webinar details

Reports

Command	Description
`zoom reports meetings --from <date> [--to <date>] [--user <id>]`	Meeting summary report
`zoom reports participants <meeting_id>`	Participant report for a past meeting

Configuration & Setup

Command	Description
`zoom init [--profile <name>]`	Set up credentials interactively
`zoom config show`	Show current configuration
`zoom config delete <profile> [--force]`	Delete a profile
`zoom schema <resource>`	Print field reference for a resource (meetings, recordings, users, reports, webinars)
`zoom completions <shell>`	Generate shell completions (bash, zsh, fish, elvish, powershell)

Shell Completions

# zsh
zoom completions zsh > ~/.zsh/completions/_zoom

# bash
zoom completions bash > /etc/bash_completion.d/zoom

# fish
zoom completions fish > ~/.config/fish/completions/zoom.fish

Agent Integration

JSON output

JSON output is automatic when stdout is not a TTY, or forced with --json. Data goes to stdout, messages to stderr.

zoom meetings list --json | jq '.[].topic'

Schema introspection

zoom schema meetings | jq '.fields'

The schema command outputs a JSON description of resource fields and types -- enabling AI agents to discover operations without parsing help text.

Exit codes

Code	Meaning
`0`	Success
`1`	General error
`2`	Auth or config error
`3`	Not found

License

MIT

zoom-cli 0.2.2