Skip to main content

CI Crates.io PyPI License: MIT codecov

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

zoomcli-0.2.7.tar.gz (81.0 kB view details)

Uploaded Source

Built Distributions

If you're not sure about the file name format, learn more about wheel file names.

zoomcli-0.2.7-py3-none-win_amd64.whl (2.9 MB view details)

Uploaded Python 3Windows x86-64

zoomcli-0.2.7-py3-none-manylinux_2_28_x86_64.whl (2.9 MB view details)

Uploaded Python 3manylinux: glibc 2.28+ x86-64

zoomcli-0.2.7-py3-none-manylinux_2_28_aarch64.whl (2.7 MB view details)

Uploaded Python 3manylinux: glibc 2.28+ ARM64

zoomcli-0.2.7-py3-none-macosx_11_0_arm64.whl (2.7 MB view details)

Uploaded Python 3macOS 11.0+ ARM64

zoomcli-0.2.7-py3-none-macosx_10_12_x86_64.whl (2.8 MB view details)

Uploaded Python 3macOS 10.12+ x86-64

File details

Details for the file zoomcli-0.2.7.tar.gz.

File metadata

  • Download URL: zoomcli-0.2.7.tar.gz
  • Upload date:
  • Size: 81.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.3

File hashes

Hashes for zoomcli-0.2.7.tar.gz
Algorithm Hash digest
SHA256 6d16975e44563d7d839798f61bd4fc57135288e69b7d29c98a7c3907fab9aebf
MD5 3d7a253a5824595f0e0a052b1be0ec63
BLAKE2b-256 717e4bc1bdeac0a7914c39576eb6ec95d2ed5a500e1b0d5e20846052c70955cc

See more details on using hashes here.

File details

Details for the file zoomcli-0.2.7-py3-none-win_amd64.whl.

File metadata

  • Download URL: zoomcli-0.2.7-py3-none-win_amd64.whl
  • Upload date:
  • Size: 2.9 MB
  • Tags: Python 3, Windows x86-64
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/7.0.0 CPython/3.12.3

File hashes

Hashes for zoomcli-0.2.7-py3-none-win_amd64.whl
Algorithm Hash digest
SHA256 66521d8a4e802999be0f17b1705e8c628585def335f4ec4f8e8a38a886ebe3b4
MD5 710514d785b09044ea7bec6aa9f0ccb7
BLAKE2b-256 7ec89be5077866e3fc0c61eb3e94aafbee6a49835b3a340588e1402b43826c1b

See more details on using hashes here.

File details

Details for the file zoomcli-0.2.7-py3-none-manylinux_2_28_x86_64.whl.

File metadata

File hashes

Hashes for zoomcli-0.2.7-py3-none-manylinux_2_28_x86_64.whl
Algorithm Hash digest
SHA256 6990104f5ac9939d875c13a751e4c643c32ee8886ede1fa127c0701d44715e93
MD5 6fd14d5a8559ed6dd25f9e971e05d0b2
BLAKE2b-256 67aa18f6b03d83f2d8d5a11838dcf981d1608c6278f3cc379952a6c7b835201e

See more details on using hashes here.

File details

Details for the file zoomcli-0.2.7-py3-none-manylinux_2_28_aarch64.whl.

File metadata

File hashes

Hashes for zoomcli-0.2.7-py3-none-manylinux_2_28_aarch64.whl
Algorithm Hash digest
SHA256 2c4a7c29b6ed61f6f8974ced26970039642354e456555d6f3696b0a3f2b50656
MD5 e290243c7511f19cb41cf2c0d0aa9a5e
BLAKE2b-256 ac509f9694ca4d72387415a72c28e29587186672dd7b9885a213c608c247eb96

See more details on using hashes here.

File details

Details for the file zoomcli-0.2.7-py3-none-macosx_11_0_arm64.whl.

File metadata

File hashes

Hashes for zoomcli-0.2.7-py3-none-macosx_11_0_arm64.whl
Algorithm Hash digest
SHA256 2f289d046ec53287b8a023d757e75e395129233dc8f6ca2a7188500cf9d23093
MD5 9b809a8171b77a3c8811c2943e9b8781
BLAKE2b-256 111ee857adf37a8fd3e8804e0842cb77e932323203afae4d2ee339c81df40fd9

See more details on using hashes here.

File details

Details for the file zoomcli-0.2.7-py3-none-macosx_10_12_x86_64.whl.

File metadata

File hashes

Hashes for zoomcli-0.2.7-py3-none-macosx_10_12_x86_64.whl
Algorithm Hash digest
SHA256 dcaa75af3a03479e45e57c363ac32f3faa5fa42b53fe995375d749d3fd29328f
MD5 31a47c85e3b78bea8342c4b791b6fc6c
BLAKE2b-256 25af11a20235a05c9a42f8e7180546b835156d592081a4a1c181723fad293972

See more details on using hashes here.

Release history Release notifications | RSS feed

0.2.8

6 files

This release

0.2.7 This release

6 files

0.2.6

6 files

0.2.5

6 files

0.2.4

6 files

0.2.3

6 files

0.2.2

6 files

0.2.1

6 files

0.2.0

6 files

0.0.1

2 files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page