Zoom Agent CLI

缩放代理cli

用于完整Zoom API的CLI和MCP服务器-专为人类和人工智能代理构建。

](https://www.npmjs.com/package/zoom-agent-cli) 

59命令 跨会议、录音、用户、网络研讨会、报告、仪表板、聊天和群组。每个命令都可以作为CLI子命令和MCP工具使用——相同的模式、相同的身份验证、一个代码库。

______________________________________________________________________

安装

npm install -g zoom-agent-cli

______________________________________________________________________

步骤1——创建Zoom服务器到服务器OAuth应用程序

此工具使用 服务器到服务器OAuth --无需浏览器登录，无需用户交互。每次请求时，您都会自动将帐户凭据替换为短期访问令牌。

创建应用程序

1. 首选 marketplace.zoom.us → 开发 → 构建应用程序
2. 选择 服务器到服务器OAuth
3. 随便命名（例如。， zoom-agent-cli)
4. 在...之下 应用程序凭据，复制您的：

- 账户ID - 客户端ID - 客户端密钥

添加所需范围

在您的应用程序中 范围 选项卡中，根据所需的命令组添加以下作用域：

提示： 要获得完全访问权限，请添加所有作用域。对于只读代理，只添加 :read:admin 变体。

激活应用程序

点击 激活您的应用程序 在Marketplace中，应用程序必须处于活动状态才能发行代币。

______________________________________________________________________

步骤2--配置凭据

提供凭据的三种方式（按此顺序选中）：

选项A——环境变量（推荐给代理）

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

选项B——交互式登录（建议用于本地CLI）

zoom login

将凭据存储在 ~/.zoom-agent-cli/config.json （模式 0600).

选项C——每个命令标志

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

______________________________________________________________________

步骤3——验证

zoom status

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

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

______________________________________________________________________

CLI使用情况

zoom [options] [command]

Options:
  --account-id        Zoom Account ID
  --client-id         Zoom Client ID
  --client-secret    Zoom Client Secret
  --output        json (default) or pretty
  --pretty                Shorthand for --output pretty
  --quiet                 Exit code only, no output
  --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)

示例

# 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 

# Get AI Companion meeting summary
zoom meetings summary 

# Get transcript for a recorded meeting
zoom recordings transcript 

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

# Send a chat message to a channel
zoom chat send-message \
  --to-channel  \
  --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服务器（用于AI代理）

每个CLI命令都可以作为MCP工具使用。启动服务器：

zoom mcp

克劳德代码/克劳德桌面配置

添加 ~/.claude.json （或您的MCP配置文件）：

{
  "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"
      }
    }
  }
}

如果全局安装：

{
  "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工具暴露

所有59个工具都遵循命名约定 {group}_{subcommand}:

______________________________________________________________________

命令参考

会议

录音

用户

过去的会议

网络研讨会

报告

仪表盘

聊天

群组

______________________________________________________________________

输出

所有命令都将JSON输出到stdout，将错误输出到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

______________________________________________________________________

建筑

每个命令定义一次 CommandDefinition object——CLI（Commander.js）和MCP工具注册都使用相同的定义。添加新命令意味着创建一个文件；两个界面都会自动接收它。

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

______________________________________________________________________

许可证

麻省理工学院--