WireCat Zoom

zoom-cli

AI エージェント向けの Zoom ミーティングと文字起こしです。 通話の前に背景を把握し、通話の後に約束を覚えておけます。

zm は、Zoom ミーティング、文字起こし、AI による要約をローカルデータベースに保存し、Claude Code、Codex、Gemini CLI、または任意の MCP クライアントに提供します。前回誰かと何を話したか、昨日の通話で何を約束したかを尋ねると、該当箇所への参照付きで回答します。

ドキュメント · コマンド · WireCat

例 — 人物名は架空で、出力は説明用です。

あなた： 3時にボブ・サンプルとの通話があります。前回は何に合意しましたか？私が彼にすべきことは何ですか？

zm personal remote-meetings list --json                      # your upcoming meetings
zm personal meetings people "Bob Sample" --json              # him among past participants
zm personal search meetings "quote" --since-time 2026-09-01 --json
zm personal meetings passage meeting:1/42/57/118 --format markdown  # the line and its context

エージェント： 最後に話したのは10月2日、「価格レビュー」でのことです。金曜日までにボブに改訂版の見積もりを送ると約束し（meeting:1/42/57/118）、年間プランにオンボーディングが含まれるか尋ねられています（meeting:1/42/57/131）。検索した保存済みミーティングには、それ以降の更新は見つかりませんでした。履歴が不足している場合、回答が変わる可能性があります。

クイックスタート

Node 22.16+（22.x）または24+、システムのキーリング、そして設定済みのユーザー管理 Zoom アプリが必要です。すでに作成済みのものか、チームがユーザー向けに用意したものを使用してください。そうでない場合は、独自のアプリを作成してください。通常の Client ID やシークレットではなく、Public Client ID を使用します。インストールガイドでは、アプリの設定、ブラウザーでの承認、コールバックの完了について説明しています。

npm install -g @wirecat/zoom-cli
zm config set zoom.client_id <public-client-id>
zm personal session start                 # "personal" is the profile; approve in your browser
zm personal meetings sync --lookback-days 7
zm personal meetings list

まず、Zoom の文字起こしの生成と保持に関する設定を確認してください。API はホスト側で利用可能なミーティングのテキストを読み取りますが、権限があっても文字起こしが作成されるわけではありません。参加したミーティングの場合は、ホストから VTT ファイルを入手するか、許可されている場合はダウンロードしてから、zm personal meetings import <folder> を実行してください。詳しくはインストールガイドをご覧ください。

詳細：インストール · Zoom アプリ · wirecat.dev の Zoom

できること

通話の準備をする。 「明日、Bob Sampleと会います。前回は何を話しましたか？」 meetings scheduledで候補となるシリーズを見つけ、meetings prepare <series-id>で選択した シリーズの次回開催を確認し、出典付きのコンテキストを収集します。meetings people、search meetings（英語、スペイン語、ロシア語の単語形にも一致する単語検索）、meetings context person:<id> を使うと、同じ人たちとの過去の会議を確認できます。インベントリにある日付のヒントだけでは、次回の通話があることの証明にはなりません。参加者の検出では、--limit、--scan-limit、--max-read-bytes、--cursorを指定できます。スキャンページが空でも、item.page.next_cursorをたどってください。返されるのは確認済みのidentity_id候補であり、推測された人物リンクは含まれません。保存済みの会議リストでは、たとえばzm personal meetings list 'started_at:[2026-09-01 TO 2026-10-01]' --jsonのように、メタデータでクエリできます。

通話の背景にあるプロジェクトを見つける。 「保存したプロジェクトのうち、この会議に関係するものはありますか？」 meetings projects scan <ref>は、ローカルにある会議の証拠を上限付きの1ページ分だけ取得し、既存のプロジェクト名、キー、別名と照合します。出典付きの候補と、確認が必要な曖昧さを返しますが、プロジェクトリンクは保存しません。エージェントは、提案されたラベルをMemoの既存の語彙とも照合できます。

会議後にフォローアップする。 「今日の通話で何を約束しましたか？」 エージェントはmeetings transcriptとmeetings summaryを読み、meetings evidenceで該当箇所を引用し、meetings task-proposal --type promiseでその箇所に紐づくフォローアップタスクをプレビューします。

履歴全体を保存する。 「1月以降の録画をすべてバックアップしてください。」 recordings download --since-time 2026-01-01 --until-time 2026-10-10 --output-dir ./zoom-archive --jsonlで 動画、音声、文字起こし、チャットをSHA-256マニフェストとともにダウンロードします。recordings scheduleを使うと毎日実行できます。

詳細：ローカルアーカイブ · 検索と証拠 · wirecat.devのZoom

AI エージェント向けに構築

• コマンドライン＋スキル。 zm skill installで、Claude Code、Codex、Gemini CLI向けのパッケージ化されたガイドを追加できます。すべてのコマンドが--jsonまたは--jsonlに対応し、zm commands --jsonですべてのコマンドの説明を確認できます。
• MCP。 zm personal mcp serveを使うと、プロファイルの権限が許す範囲で、zmのコマンドをClaude Desktop、Cursor、その他のMCPクライアントに提供できます。zm mcp serve --profiles allを使うと、1つのサーバーからすべてのプロファイルを提供できます。 クライアントの接続。

あなたのエージェント。あなたの会議。あなたのルール。

詳細：MCPとスキル · AI エージェントの接続

zmを選ぶ理由

• 会議をまたいだコンテキスト。 利用可能なホスト型の会議と、共有ストアにインポートされた文字起こしを検索できます。アーカイブ済みの文字起こしは個別に読むか、一緒に検索する前にインポートしてください。
• ローカル優先。 会議は、お使いのマシン上のSQLiteデータベースに保存されます。アーカイブ済みの文字起こしは、ログインせずにオフラインで読んだり検索したりできます。
• すべての回答に出典があります。 meeting:1/42/57/118のような参照は、特定の文字起こしリビジョン内の1つの箇所を指します。修正された文字起こしも履歴が保持されます。
• エージェント向けに設計。 JSON出力、完了状況が明示された上限付き読み取り、スキル、MCP サーバーを備えています。
• デフォルトで安全。 独自のZoomアプリを使用し、トークンはキーチェーンにのみ保存され、権限はプロファイルごとに設定されます。Zoomへの変更はすべて、ターミナルで事前に確認を求めます。MCP経由ではターミナルがないため、askは質問なしで実行されます。変更を止めるには、denyまたはreadonlyを使用してください。

詳細：セキュリティ · wirecat.devのZoom

現在できることと、まだできないこと

zm はバージョン 0.x のため、コマンドは今後変更される可能性があります。現在は、Zoom の公式 API を通じてアカウントで利用できるホスト済みのミーティング、参加者、文字起こし、AI 要約を読み込み、ダウンロード済みの WebVTT ファイルをインポートし、クラウド録画をアーカイブし、インストール済みの音声モデルでローカル音声を文字起こしし、ミーティングをイベントや人物に関連付け、シンプルなミーティングを作成、変更、キャンセルできます。

• コミットメントを自動で見つけることはありません。 文字起こしから見つけるのはエージェントです。task-proposal はタスクをプレビューするだけで、何も作成しません。
• 人物は手動で関連付けます。 zm が話者名から人物を推測することはありません。人物のコンテキストに含まれるのは、たとえば meetings link で人物に関連付け済みの参加者です。
• ローカルでの文字起こしには、すぐに使える WAV 以外の場合は ffmpeg が必要です。また、zm models download でダウンロードしたモデルも必要です。 話者は不明のままです。
• 出席したミーティングは、Zoom ポータルから手動でダウンロードしてから zm personal meetings import を実行する必要があります。
• 会社管理の Zoom アカウントでは、アプリの承認を管理者に依頼する必要がある場合があります。
• 日次アーカイブジョブをインストールできるのは Linux のみです。 それ以外のプラットフォームではプレビューできます。
• 現時点では Zoom のみです。 Google Meet と Microsoft Teams はロードマップに記載されています。

詳細：予定されている内容 · wirecat.dev の Zoom

詳細：他のツールとの比較 · wirecat.dev で見る

タスク別コマンド

タスク	コマンド
セットアップとログイン	config show、config set <key> <value>、config unset <key>、session start [--browser <program>]、session status [--check]、doctor
会議を取り込む	meetings sync [--since-time <time>] [--lookback-days <days>]、meetings import <folder>、watch [api|files] [folder] --jsonl
保存済みの会議を読む	meetings list、meetings show <meeting>、meetings transcript <meeting>、meetings summary <meeting>、meetings export <meeting> --format markdown|vtt、events list
検索	search meetings <query>、meetings people <query>、search all <query>
根拠と人物	meetings passage <reference>、meetings evidence <reference>、meetings context <person>、meetings link <reference>、meetings update <reference>、meetings task-proposal <reference> --type <type>
複数の読み取りを一度に実行	batch <file> は、JSON ファイルから制限付きの search meetings および meetings passage リクエストを実行します
意味で検索	search meetings <query> --model <model>、meetings embeddings --model <model>
ローカルで文字起こし	meetings transcribe <meeting> <file> --model <model>
クラウド録画	recordings list、recordings show <meeting>、recordings download <meeting> --output-dir <dir>、recordings download --since-time <date> --until-time <date> --output-dir <dir> --jsonl、recordings schedule create|list|show|run|disable
ローカルアーカイブ	recordings archive show|check|locks|recover <directory>、recordings archive transcript|import <directory>、search recordings <directory> <query>
Zoom 会議	remote-meetings list|show|invitation、remote-meetings create|update|cancel
Zoom の連絡先	contacts list [name:… email:… type:company|external]、contacts show <member id|email>
zm の動作	runs list [query]、runs show <run-id> [--problems]、runs path <run-id>；--record を指定すると、成功した実行も記録します
Zoom 独自の検索	zoom search：zm がアーカイブしていないチャット、ドキュメント、会議をライブで読み取ります
エージェント	mcp serve、skill show、skill install [--for claude|agents|all]、commands --json、complete -- <words...>

Zoom 会議の変更、リンク、文字起こし、スケジュール、明示的な meetings embeddings の生成、ロックの復旧は、デフォルトでプレビューを表示し、--yes を指定すると一度実行します。--dry-run を指定するとプレビューのままになります。単語検索ではインデックスが自動で更新されます。--model を指定した検索では、ランキングの前に不足しているベクトルを生成します。明示的に選択したリモート埋め込みエンドポイントには、該当する文字起こしの文章とクエリが送信されます。

詳細：使い方 · すべてのコマンドとオプション · wirecat.dev の Zoom

Zoom アプリとログイン

zm は、パブリッククライアント OAuth を使用する設定済みのユーザー管理 Zoom アプリを通じて、Zoom の公式 API でミーティングを読み取ります。ユーザーが利用できる既存のアプリを再利用するか、新しく作成してください。パブリッククライアント OAuth を有効にし、パブリッククライアント ID をコピーして、リダイレクトを設定し、必要なスコープを手動で追加してください。オプションのスターターマニフェストには、スコープもパブリッククライアント OAuth も含まれていません。Zoom にクライアントシークレットが表示される場合がありますが、zm は使用しません。録画アーカイブと管理には、追加のスコープが必要です。アプリのセットアップガイドに従ってください。認証情報ファイルはダウンロードされません。

zm personal session start は Zoom の同意ページを開きます。Zoom は静的ページ https://wirecat.dev/zoom-callback にリダイレクトします。このページは応答をお使いのマシン上のリスナーに渡します。渡せない場合は、表示された code=…&state=… パラメーターを貼り付けてください。ログイン時には state と PKCE verifier が検証され、トークンはシステムのキーリングにのみ保存されます。エージェントのシェルなど、ターミナルがない場合、ログインはエージェントが引き継げるように URL を stderr に出力し、コールバックを待ちます。--no-input と CI ではログインできません。zm personal session status は更新せずにキャッシュ済みの状態を読み取ります。--check は Zoom に問い合わせます。

詳細：お使いの Zoom アプリ · ログインとセッション · wirecat.dev の Zoom

プロファイルとローカルストア

最初の語がプロファイルです：zm personal meetings list。プロファイルは、Zoom への 1 回のログインと、そのミーティングをストア内で管理する単位です。zm work session start を実行すると、2 つ目のプロファイルが作成されます。シェルセッションでは ZM_PROFILE でプロファイルを指定し、ZM_PROFILE_LOCK でプロセスを 1 つのプロファイルに固定します。プロファイルは自動選択されません。プロファイルを指定せずにアカウントを使うコマンドを実行すると停止し、このコンピューター上のプロファイルが一覧表示されます。名前には、1～64 文字の英字、数字、ピリオド、アンダースコア、ハイフンを使用できます。ログインするとプロファイルが作成されます。プロファイルがまだないコンピューターでは、最初のインポートでも作成されます。他のプロファイルがある状態で、不明なプロファイルを指定したインポートまたはプルを実行すると拒否されるため、タイプミスによってデータが保存されることはありません。

ミーティングは、ほかの WireCat ツールのデータと同じ共有 WireCat データベース wirecat.db に保存されます。MESSAGING_STORE で別のパスを指定できます。ストアを開いても、レガシーの messages.db ファイルとそのサイドカーファイルは保持されます。これらの保持期間は別途管理してください。メタデータ、ヘルプ、設定、ログインではデータベースを開きません。

詳細：プロファイル · ミーティングの保存場所 · wirecat.dev の Zoom

プル、インポート、監視

zm personal meetings sync --lookback-days 7                       # hosted meetings, revisiting late transcripts
zm personal meetings import ./downloaded-transcripts              # .vtt or zoom-searcher .txt files
zm personal watch api --lookback-days 7 --jsonl                   # keep pulling in the foreground

カーソルだけでは、後から表示されたトランスクリプトを再取得しません。--lookback-days または、より古い --since-time を使用してください。失敗した回はカーソルが変更されず、次回のプルで再試行されます。インポートしたファイルの名前は、エクスポーターに従って YYYY-MM-DD_HHMM_topic-slug.vtt、または zoom-searcher ヘッダーが付いた .txt になります。時刻は、このコンピューターのタイムゾーンで読み取られます。files.timezone に別のタイムゾーンを指定した場合は、そのタイムゾーンが使われ、インポート時に通知されます。.txt の話者は、そのミーティングの参加者になります。話者名がミーティングをまたいで同一人物として扱われることはありません。

詳細：ローカルアーカイブ · wirecat.dev の Zoom

クラウド録画をアーカイブする

zm personal recordings download --since-time 2026-01-01 --until-time 2026-10-10 --output-dir ./zoom-archive --jsonl
zm personal recordings archive check ./zoom-archive --offline --json
zm personal search recordings ./zoom-archive "example plan" --offline --json

同期では、最大10年分を月ごとのリクエストに分けてシリアルにダウンロードし、ディスクにストリーミングします。各録画には、サイズと SHA-256 チェックサムを記載したマニフェストが付属し、署名付き URL やトークンは含まれません。既存のファイルは上書きされず、再実行時には検証済みのファイルがスキップされます。プロファイルを指定すると、中断したダウンロードを安全に再開できます。recordings archive transcript と search recordings は、検証済みの WebVTT をデータベースなしでオフライン読み込みします。recordings archive import は、それらを保存済みのミーティングに追加します。recordings schedule create --yes は、毎日実行する systemd ユーザータイマーをインストールします（Linux のみ）。

ダウンロードできる内容は、Zoom の権限、保存期間、プランによって異なります。自分が参加しただけのミーティングの録画は、API 経由では利用できない場合があります。

詳細：クラウド録画のアーカイブ · 毎日のバックアップ · wirecat.dev の Zoom

検索とエビデンス

zm personal search meetings "example plan" --limit 20 --json       # word search with continuation
zm personal meetings evidence meeting:3/15/20/0 --cues 100 --json  # the exact passage
zm personal meetings context person:7 --meetings 10 --json         # meetings linked to a person

search meetings はまず新しいミーティングをインデックス化し、すべての単語を、接頭辞または保存されている英語、スペイン語、ロシア語の語形で照合して、不透明な --cursor を使ってページ分割します。参照は meeting:<account>/<meeting>[/<transcript>[/<cue-position>]] の形式で、選択したアカウント内にとどまり、修正後も同じリビジョンを指し続けます。範囲を限定した読み取りでは、その対象範囲と制限が報告されます。アーカイブが完全かどうかは不明なままの場合があります。search all --only meetings,notes は、ストア全体のノートも検索対象に加えます。search meetings --model は、指定したモデルを使って意味に基づく検索を行います。モデルは自動ではダウンロードされません。

詳細：検索とエビデンス · トピック検索 · wirecat.dev の Zoom

ローカルでの文字起こし

Zoom の文字起こしがありませんか？zm personal meetings transcribe 1 ./call.m4a --model <model> --yes は録画を認識し、別の文字起こしとして追加します。対象は、インストール済みの ffmpeg を使う Zoom の MP4 または M4A、あるいはそのまま使用できる16 kHzまたは48 kHzの PCM16 WAV です。ローカル音声モデルは zm models download <model> で取得します。プレビューでは、モデルを読み込まずにファイルを確認します。タイムスタンプは最大30秒の区間を対象とし、話者は不明のままです。

詳細：ローカル音声の文字起こし · wirecat.dev の Zoom

MCP とエージェントのセットアップ

zm skill install は、同梱のガイドを ~/.claude/skills/zoom-cli/（Claude Code）と ~/.agents/skills/zoom-cli/（Codex、Gemini CLI）に書き込みます。--for で対象を選択できます。MCP クライアントは、対象プロファイルを指定してサーバーを起動します。

{ "mcpServers": { "zoom": { "command": "zm", "args": ["personal", "mcp", "serve"] } } }

サーバーは、zm のコマンドを、すべての WireCat CLI が提供する3つのツール（zm_tools_search、zm_read、 zm_write）として公開し、各呼び出しをコマンドラインから実行した場合と同様に実行します。プロファイルの権限によって、利用できる機能が決まります。{"remote-meetings": "readonly"} を設定すると、エージェントによる Zoom ミーティングの変更を防げます。デスクトップアプリでは、command -v zm（Linux/macOS）または where.exe zm（Windows）で確認できるフルパスと、エントリーの env に同じ ZM_CONFIG_DIR または MESSAGING_STORE を指定する必要がある場合があります。

詳細：MCP とスキル · wirecat.dev の MCP とスキル · AI エージェントを接続する

Zoom ミーティングを管理する

zm personal remote-meetings create --title "Example planning" --start-time 2026-10-20T10:00:00Z --duration-minutes 30 --dry-run --json
zm personal remote-meetings cancel 123456789 --dry-run --json

作成、更新、キャンセルは、--yes を追加するまでプレビューとして実行され、自動で再試行されることはありません。結果が不確かな場合は終了コード14で終了します。繰り返し操作する前に Zoom を確認してください。リモート ID は Zoom の数値 ID です。保存済みの meetings コマンドではローカル ID を使用します。

詳細：Zoom ミーティングの管理 · wirecat.dev の Zoom

出力、上限、期限

--json は1つの回答エンベロープを出力し、--jsonl は型付きの項目レコードと最後の終了レコードを出力します。パイプに出力する場合はデフォルトで JSON になり、エラーは stderr に出力されます。--json=id,title はそれらのフィールドだけを残し、--offline はネットワークへの接続を拒否します。--max-output-bytes で指定しない限り、出力は 4 MiB に制限されます。デフォルトの期限は、読み取りが30秒、ログインが5分、ダウンロード、同期、検証が1時間です。--timeout 5m で変更できます。監視と MCP サーバーの実行は停止するまで続きます。すべての形式で時刻は UTC です。時刻を表示するテキスト出力の末尾には times in UTC と表示されます。

詳細：使い方 · wirecat.dev の Zoom

設定

設定	意味
zoom.client_id	Zoom アプリの Public Client ID
source	meetings sync と watch の api または files
files.folder, files.timezone	文字起こしファイルのフォルダーと、ファイル名に使われるタイムゾーン
ZM_CONFIG_DIR	別の設定ディレクトリ（キーチェーンのエントリも変更されます）
ZM_STATE_DIR, ZM_CACHE_DIR	別の状態（記録された実行）ディレクトリまたはキャッシュディレクトリ
ZM_READ_ONLY	1 の場合、読み取りと同期のみを許可します。それ以外の変更では終了コード 5 が返されます（セキュリティ）
WIRECAT_STATE_DIR	別の WireCat フォルダー。デフォルトのデータベースは ~/.local/share/WireCat/wirecat.db です
MESSAGING_STORE	別の共有データベースパス
OPENAI_API_KEY	選択した OpenAI の埋め込みエンドポイントでのみ使用

詳細：設定 · wirecat.dev の Zoom

セキュリティモデル

• PKCE を使用する、設定済みの Zoom パブリッククライアントアプリを使います。クライアントシークレットは使用しません。
• トークンはシステムのキーチェーンにのみ保存され、設定ファイルには保存されません。キーチェーンが見つからない場合はエラーになります。
• ネットワーク接続先は Zoom の API と、指定した場合のみ埋め込みエンドポイントです。--offline は両方への接続を拒否します。
• マニフェストと保存済みジョブには、署名付き URL、トークン、認証情報は保存されません。診断情報からはプロバイダーの生のエラーテキストが除外されます。
• MCP サーバーは、1つの固定プロファイルに対して、権限で制限された読み取りと書き込みを提供します。ask の書き込みは、ターミナルでの確認なしに実行されます。
• ZM_READ_ONLY=1 は、Zoom、ログイン、設定、および追加したもの（インポート、リンク、文字起こし、エクスポート、ジョブ）への変更を、ネットワーク呼び出しの前に終了コード 5 で拒否します。Zoom からストアまたはアーカイブへデータをコピーする読み取りと同期は引き続き実行できます。読み取りのみを許可するエージェントに設定してください。

詳細：セキュリティ · wirecat.dev のセキュリティ

トラブルシューティング

• Zoom の「Invalid redirect」： マニフェストのインポート後にリダイレクト URL または Public Client OAuth が未設定のままになっています。手動で入力してください。
• 文字起こしがない： アプリガイドで生成、保持期間、権限を確認してください。設定を有効にしても、削除済みのテキストは復元されません。参加した会議については zm personal meetings import が必要な場合があります。
• スコープ不足のエラー： アプリに指定されたスコープを追加し、zm personal session start をもう一度実行してください。
• ブラウザーが起動しない： zm personal session start --browser firefox を実行するか、コールバックのパラメーターを貼り付けてください。
• クラッシュ後にロックが残っている： zm personal recordings archive locks を実行してから、--yes を付けて recover を実行してください。

詳細：トラブルシューティング · wirecat.dev の Zoom

WireCat の一部

zm は、AI エージェント向けのオープンソースのローカルファーストなコンテキストレイヤーである WireCat の一部です。会議データは、Telegram、MAX、メモのデータと同じローカルストアに保存され、zm personal search all "<query>" --only meetings,notes を使うと、会議データをメモとまとめて検索できます。まずは Zoom から始めてください。必要に応じて、コンテキストを追加しましょう。あなたのコンテキスト。あらゆるエージェントに。

詳細：wirecat.dev · AI エージェントを接続する

技術ドキュメント

ページ	内容
概要	zm とは何か、1 分で始める方法
インストール	要件、初回実行、ファイルの保存先、補完
Zoom アプリ	アプリの作成、スコープ、会社アカウント
ログイン、セッション、プロファイル	OAuth ログイン、キーリング、ローカルプロファイル
使い方	すべてのコマンドグループ、出力、期限
ローカルアーカイブ	取得、インポート、監視、録画、バックアップ、文字起こし
検索とエビデンス	単語検索、エビデンス、人物、リンク、メモ
トピック検索	選択したモデルを使った意味による検索
MCP とスキル	スキル、MCP サーバー、オプションのツール
Zoom ミーティングの管理	今後のミーティング、作成、更新、キャンセル
コマンド	すべてのコマンド、オプション、終了コード（自動生成）
設定	設定と環境変数
トラブルシューティング	症状別
セキュリティ	ディスクとネットワークに送られる情報
アーキテクチャ · テスト · リリース	コントリビューター向け

wirecat.dev の Zoom ガイドには、セットアップ、検索、アーカイブの手順が記載されています。

開発

Node 22.16 以降の 22.x、または Node 24 以降：

pnpm install
pnpm lint && pnpm typecheck && pnpm test:coverage && pnpm docs:check
pnpm build && pnpm smoke:bun

フィクスチャでは架空の人物とミーティングを使用します。テストでは、注入されたキーリング、スクリプト化された HTTP レスポンス、一時的な設定フォルダー、メモリ上のミーティングストアを使用します。pnpm generate:check は生成されたコマンドリファレンスを確認し、pnpm test:matrix はコマンドとオプションのカバレッジを測定します。

詳細：開発環境のセットアップ · テストマトリックス

Licence

Apache License 2.0.