zoomcli 0.2.5

Agent-friendly CLI for the Zoom API

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