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

# Verify the active profile against Zoom
zoom auth status

# 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

active_profile = "default"

[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

Precedence

CLI flags > environment variables > config file

Use the same account workflow as the other enterprise CLIs:

zoom init --profile work
zoom auth login --profile work
zoom auth status [--offline] --profile work
zoom auth logout --profile work
zoom profile list
zoom profile use work
zoom profile remove work --yes
zoom config show
zoom config path
zoom doctor [--offline]

auth status and doctor verify credentials against Zoom by default. Their --offline option validates only local configuration. auth logout removes the stored client secret but preserves the rest of the profile. Environment variables still take precedence and cannot be removed by the CLI.

Commands

Meetings

Recordings

Users

Webinars

Reports

Configuration & Setup

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 | jq '.commands[] | select(.name == "meetings list")'

The schema command outputs a JSON description of commands, arguments, and result fields -- enabling agents to discover operations without parsing help text.

Exit codes

License

MIT

Releasing

Vership owns versioning, changelog generation, release commits, and tags. See the release runbook for the verified workflow and recovery policy.