Zoom CLI

Zoom REST API の Meeting 操作をコマンドラインから実行できる CLI ツール。

前提条件

• Node.js 18 以上
• Zoom アカウント（Pro / Business / Enterprise いずれか）

Zoom Server-to-Server OAuth アプリの作成

1. Zoom App Marketplace にアクセス

https://marketplace.zoom.us/ にサインインする。

2. アプリを作成

1. 右上の 「Develop」 → 「Build App」 をクリック
2. 「Server-to-Server OAuth」 を選択し 「Create」 をクリック
3. アプリ名を入力（例: zoom-cli）して作成

3. 認証情報を取得

作成後の 「App Credentials」 タブに以下が表示される。

| 項目 | 環境変数 | |---|---| | Account ID | ZOOM_ACCOUNT_ID | | Client ID | ZOOM_CLIENT_ID | | Client Secret | ZOOM_CLIENT_SECRET |

この 3 つを控えておく。

4. スコープを設定

「Scopes」 タブで以下を追加する。

| スコープ | 用途 | |---|---| | meeting:read:admin | ミーティングの一覧・詳細取得 | | meeting:write:admin | ミーティングの作成・更新・削除 |

個人ユーザー向けの場合は meeting:read / meeting:write でも可。

5. アプリを有効化

「Activation」 タブで 「Activate your app」 をクリックする。

ステータスが 「Activated」 になれば準備完了。

セットアップ

# 依存パッケージのインストール
npm install

# .env ファイルを作成
cp .env.example .env

.env を編集して、取得した認証情報を設定する。

ZOOM_ACCOUNT_ID=your_account_id
ZOOM_CLIENT_ID=your_client_id
ZOOM_CLIENT_SECRET=your_client_secret

ビルド

npm run build

コマンド一覧

ミーティング一覧

npm run dev -- meeting list
npm run dev -- meeting list -n 10          # 取得件数を指定
npm run dev -- meeting list --type live    # 実行中のミーティングを取得
npm run dev -- meeting list --type upcoming # 今後のミーティングを取得
npm run dev -- meeting list --json         # JSON で出力

| オプション | 必須 | 説明 | |---|---|---| | -n, --page-size | No | 1 ページあたりの取得件数。デフォルト 30 | | --type | No | ミーティングの種類でフィルター。デフォルト scheduled |

--type に指定できる値:

| 値 | 説明 | |---|---| | scheduled | スケジュール済み（デフォルト） | | live | 現在実行中のミーティング | | upcoming | 今後予定されているミーティング | | pending | 承認待ちのミーティング |

ミーティング作成

npm run dev -- meeting create -t "定例会議" -s "2026-03-01T10:00:00Z" -d 60
npm run dev -- meeting create -t "朝会" -s "2026-03-01T01:00:00Z" -d 15 --timezone Asia/Tokyo
npm run dev -- meeting create -t "Test" --json

| オプション | 必須 | 説明 | |---|---|---| | -t, --topic | Yes | ミーティングのトピック | | -s, --start-time | No | 開始日時（ISO 8601 形式） | | -d, --duration | No | 所要時間（分）。デフォルト 60 | | --timezone | No | タイムゾーン（例: Asia/Tokyo） | | --agenda | No | アジェンダ | | --password | No | パスワード |

ミーティング詳細

npm run dev -- meeting get 12345678901
npm run dev -- meeting get 12345678901 --json

ミーティング更新

npm run dev -- meeting update 12345678901 -t "新しいトピック"
npm run dev -- meeting update 12345678901 -d 90 --timezone Asia/Tokyo

ミーティング削除

npm run dev -- meeting delete 12345678901

共通オプション

| オプション | 説明 | |---|---| | --json | 出力を JSON 形式に切り替え（スクリプト連携向け） | | -h, --help | ヘルプを表示 | | -V, --version | バージョンを表示 |

ビルド後の実行

npm run build
node dist/index.js meeting list

グローバルインストールする場合:

npm link
zoom meeting list

トラブルシューティング

| エラー | 原因と対処 | |---|---| | Environment variable ZOOM_ACCOUNT_ID is required | .env ファイルが存在しない、または値が空 | | Zoom API error (401) | 認証情報が不正。Client ID / Secret を確認する | | Zoom API error (124) | 無効な access token。アプリが Activated か確認する | | Zoom API error (3001) | 存在しない Meeting ID | | Zoom API error (429) | レートリミット超過。時間を置いて再実行する | | scopes 関連のエラー | Marketplace のアプリ設定でスコープが足りていない |