zoom-agent-cli

CLI and MCP server for the full Zoom API — built for humans and AI agents.

59 commands across meetings, recordings, users, webinars, reports, dashboard, chat, and groups. Every command is available both as a CLI subcommand and as an MCP tool — same schema, same auth, one codebase.

---

Install

npm install -g zoom-agent-cli

---

Step 1 — Create a Zoom Server-to-Server OAuth App

This tool uses Server-to-Server OAuth — no browser login, no user interaction. You exchange account credentials for a short-lived access token automatically on every request.

Create the app

1. Go to marketplace.zoom.us → Develop → Build App
2. Choose Server-to-Server OAuth
3. Name it anything (e.g., zoom-agent-cli)
4. Under App Credentials, copy your:
   • Account ID
   • Client ID
   • Client Secret

Add required scopes

In your app's Scopes tab, add these scopes based on which command groups you need:

Group	Required Scopes
meetings	meeting:read:admin meeting:write:admin
recordings	recording:read:admin recording:write:admin
users	user:read:admin user:write:admin
webinars	webinar:read:admin webinar:write:admin
reports	report:read:admin
dashboard	dashboard:read:admin dashboard_meetings:read:admin
chat	chat_channel:read:admin chat_channel:write:admin chat_message:read:admin chat_message:write:admin
groups	group:read:admin group:write:admin
AI summary	meeting_summary:read:admin

Tip: For full access add all scopes. For a read-only agent, add only the :read:admin variants.

Activate the app

Click Activate your app in the Marketplace — the app must be active for tokens to be issued.

---

Step 2 — Configure Credentials

Three ways to provide credentials (checked in this order):

Option A — Environment variables (recommended for agents)

export ZOOM_ACCOUNT_ID="your-account-id"
export ZOOM_CLIENT_ID="your-client-id"
export ZOOM_CLIENT_SECRET="your-client-secret"

Option B — Interactive login (recommended for local CLI use)

zoom login

Stores credentials in ~/.zoom-agent-cli/config.json (mode 0600).

Option C — Per-command flags

zoom meetings list \
  --account-id "..." \
  --client-id "..." \
  --client-secret "..."

---

Step 3 — Verify

zoom status

Credentials found:
  Account ID: 12345678...
  Client ID:  abcdefgh...
  Client Secret: ****

Testing API connection...
Connected as: Jane Doe (jane@example.com)

---

CLI Usage

zoom [options] [command]

Options:
  --account-id <id>       Zoom Account ID
  --client-id <id>        Zoom Client ID
  --client-secret <sec>   Zoom Client Secret
  --output <format>       json (default) or pretty
  --pretty                Shorthand for --output pretty
  --quiet                 Exit code only, no output
  --fields <fields>       Comma-separated fields to return

Commands:
  login                   Store credentials interactively
  logout                  Remove stored credentials
  status                  Test connectivity
  mcp                     Start MCP server (stdio)
  meetings                Manage meetings (9 commands)
  recordings              Manage recordings (7 commands)
  users                   Manage users (6 commands)
  past-meetings           Access past meeting data (2 commands)
  webinars                Manage webinars (10 commands)
  reports                 Usage and audit reports (6 commands)
  dashboard               Quality metrics (4 commands)
  chat                    Team Chat channels and messages (8 commands)
  groups                  User groups (7 commands)

Examples

# List upcoming meetings
zoom meetings list --type upcoming --pretty

# Create a scheduled meeting
zoom meetings create \
  --topic "Sprint Review" \
  --type 2 \
  --duration 60 \
  --start-time "2026-03-15T14:00:00Z" \
  --timezone "America/New_York"

# Get recording files with download URLs
zoom recordings get <meeting-id>

# Get AI Companion meeting summary
zoom meetings summary <meeting-uuid>

# Get transcript for a recorded meeting
zoom recordings transcript <meeting-id>

# Get past meeting participants with join/leave times
zoom past-meetings participants <meeting-uuid>

# Send a chat message to a channel
zoom chat send-message \
  --to-channel <channel-id> \
  --message "Deployment complete ✓"

# Pull admin operation logs
zoom reports operation-logs --from 2026-03-01 --to 2026-03-13

# Filter output to specific fields
zoom users list --fields id,email,first_name,last_name --pretty

---

MCP Server (for AI Agents)

Every CLI command is also available as an MCP tool. Start the server:

zoom mcp

Claude Code / Claude Desktop config

Add to ~/.claude.json (or your MCP config file):

{
  "mcpServers": {
    "zoom": {
      "command": "npx",
      "args": ["-y", "zoom-agent-cli", "mcp"],
      "env": {
        "ZOOM_ACCOUNT_ID": "your-account-id",
        "ZOOM_CLIENT_ID": "your-client-id",
        "ZOOM_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

If installed globally:

{
  "mcpServers": {
    "zoom": {
      "command": "zoom",
      "args": ["mcp"],
      "env": {
        "ZOOM_ACCOUNT_ID": "your-account-id",
        "ZOOM_CLIENT_ID": "your-client-id",
        "ZOOM_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

MCP tools exposed

All 59 tools follow the naming convention {group}_{subcommand}:

Tool	Description
meetings_list	List meetings for a user
meetings_get	Get meeting details
meetings_create	Create a meeting
meetings_update	Update a meeting
meetings_delete	Delete a meeting
meetings_end	End a live meeting
meetings_summary	Get AI Companion meeting summary
recordings_list	List cloud recordings
recordings_get	Get recording files and download URLs
recordings_transcript	Get meeting transcript
recordings_settings	Get recording sharing settings
users_list	List all account users
users_get	Get user details
past_meetings_get	Get past meeting instance details
past_meetings_participants	Get participant list with join/leave times
webinars_list	List webinars
webinars_get	Get webinar details
reports_daily	Daily usage report
reports_meeting_participants	Participant report for a meeting
reports_operation_logs	Admin operation audit log
dashboard_meetings	Live/past meetings with quality metrics
dashboard_quality	Overall quality scores
chat_list_channels	List chat channels
chat_send_message	Send a message to channel or contact
chat_list_messages	List chat message history
groups_list	List all groups
…	(59 total — run zoom mcp to see all)

---

Command Reference

meetings

Command	Description
zoom meetings list [options]	List meetings (--type upcoming|live|scheduled)
zoom meetings get <meetingId>	Get meeting details
zoom meetings create [options]	Create a meeting
zoom meetings update <meetingId> [options]	Update a meeting
zoom meetings delete <meetingId>	Delete a meeting
zoom meetings end <meetingId>	End a live meeting
zoom meetings list-registrants <meetingId>	List registrants
zoom meetings add-registrant <meetingId>	Add a registrant
zoom meetings summary <meetingId>	Get AI Companion summary

recordings

Command	Description
zoom recordings list [options]	List cloud recordings (--from, --to)
zoom recordings get <meetingId>	Get recording files and download URLs
zoom recordings transcript <meetingId>	Get meeting transcript
zoom recordings settings <meetingId>	Get recording settings
zoom recordings delete <meetingId>	Move recordings to trash
zoom recordings delete-file <meetingId> <recordingId>	Delete a specific file
zoom recordings recover <meetingId>	Recover from trash

users

Command	Description
zoom users list [options]	List all users
zoom users get <userId>	Get user details (use me for yourself)
zoom users create [options]	Create a user
zoom users update <userId> [options]	Update user profile
zoom users delete <userId>	Delete or disassociate a user
zoom users settings <userId>	Get user settings

past-meetings

Command	Description
zoom past-meetings get <uuid>	Get past meeting instance details
zoom past-meetings participants <uuid>	Get participants with join/leave times

webinars

Command	Description
zoom webinars list [options]	List webinars
zoom webinars get <id>	Get webinar details
zoom webinars create [options]	Create a webinar
zoom webinars update <id> [options]	Update a webinar
zoom webinars delete <id>	Delete a webinar
zoom webinars list-registrants <id>	List registrants
zoom webinars add-registrant <id>	Add a registrant
zoom webinars list-panelists <id>	List panelists
zoom webinars add-panelists <id>	Add panelists
zoom webinars list-polls <id>	List polls

reports

Command	Description
zoom reports daily	Daily usage report (--year, --month)
zoom reports users	Active/inactive host report (--from, --to)
zoom reports meeting <id>	Meeting detail report
zoom reports meeting-participants <id>	Participant report
zoom reports cloud-recording	Cloud recording usage report
zoom reports operation-logs	Admin operation audit log

dashboard

Command	Description
zoom dashboard meetings	List meetings with quality metrics
zoom dashboard meeting-detail <id>	Meeting quality detail
zoom dashboard meeting-participants <id>	Participant quality metrics
zoom dashboard quality	Overall quality scores

chat

Command	Description
zoom chat list-channels	List channels
zoom chat get-channel <id>	Get channel details
zoom chat create-channel	Create a channel
zoom chat list-messages	List messages (--to-channel or --to-contact)
zoom chat send-message	Send a message
zoom chat update-message <id>	Update a message
zoom chat delete-message <id>	Delete a message
zoom chat list-members <id>	List channel members

groups

Command	Description
zoom groups list	List all groups
zoom groups get <id>	Get group details
zoom groups create	Create a group
zoom groups update <id>	Rename a group
zoom groups delete <id>	Delete a group
zoom groups list-members <id>	List members
zoom groups add-members <id>	Add members

---

Output

All commands output JSON to stdout, errors to stderr.

# Compact JSON (default — pipe-friendly)
zoom meetings list

# Indented JSON (human-readable)
zoom meetings list --pretty

# Select specific fields
zoom users list --fields id,email,first_name --pretty

# Suppress output (exit code only — for scripts)
zoom meetings delete 12345 --quiet
echo $?   # 0 = success, 1 = error

---

Architecture

Each command is defined once as a CommandDefinition object — the same definition powers both the CLI (Commander.js) and MCP tool registration. Adding a new command means creating one file; both interfaces pick it up automatically.

src/
├── core/
│   ├── client.ts    # S2S OAuth with automatic token refresh
│   ├── handler.ts   # executeCommand() — routes fields to path/query/body
│   └── auth.ts      # flag > env > config resolution
├── commands/        # One file per command
└── mcp/server.ts    # Registers all CommandDefinitions as MCP tools

---

License

MIT — github.com/bcharleson/zoom-agent-cli