WireCat Zoom

zoom-cli

Zoom meetings and transcripts for your AI agent. Know the context before the call. Remember the commitments after it.

zm keeps your Zoom meetings, transcripts and AI summaries in a local database and gives them to Claude Code, Codex, Gemini CLI or any MCP client. Ask what you discussed with someone last time, or what you promised in yesterday's call, and get the answer with a reference to the exact passage.

Documentation · Commands · WireCat

Example — invented people, illustrative output:

You: I have a call with Bob Sample at three. What did we agree last time, and what do I owe him?

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

Agent: You last spoke on 2 October in "Pricing review". You promised Bob a revised quote by

Friday (meeting:1/42/57/118), and he asked whether the annual plan includes onboarding

(meeting:1/42/57/131). I found no later update in the stored meetings I searched; missing

history may change that.

Quick start

You need Node 22.16+ (22.x) or 24+ and a configured user-managed Zoom app; a system keyring is best. Reuse one you already created or one your team has made available to your user; otherwise create your own. Use its Public Client ID, not its regular Client ID or secret. The installation guide walks through app settings, browser approval and callback completion.

npm install -g @wirecat/zoom-cli

zm config set zoom.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

Check Zoom's transcript generation and retention settings first: the API reads available hosted meeting text, and permission does not create a transcript. For an attended meeting, obtain a VTT file from the host or download one if allowed, then run zm personal meetings import . Full guide: installation.

More: installation · your Zoom app · Zoom on wirecat.dev

What you can do

Prepare for a call. *"I meet Bob Sample tomorrow. What did we talk about last time?"* meetings scheduled finds candidate series; meetings prepare checks the selected series’ next occurrence and gathers cited context. meetings people, search meetings (word search that also matches English, Spanish and Russian word forms) and meetings context person: bring back past meetings with the same people. Inventory date hints alone do not prove the next call. Participant discovery accepts --limit, --scan-limit, --max-read-bytes and --cursor; follow item.page.next_cursor even after an empty scan page. It returns observed identity_id candidates, never inferred person links. Stored meeting lists accept metadata queries, for example zm personal meetings list 'started_at:[2026-09-01 TO 2026-10-01]' --json.

Find the project behind a call. *"Which of my saved projects might this meeting concern?"* meetings projects scan compares one bounded page of local meeting evidence with existing project names, keys and aliases. It returns cited suggestions and ambiguity for review, saving no project link. The agent can check proposed labels against Memo's existing vocabulary too.

Follow up after it. *"What did I promise in today's call?"* The agent reads meetings transcript and meetings summary, cites passages with meetings evidence, and meetings task-proposal --type promise previews a follow-up task tied to that passage.

Keep the whole history. *"Back up every recording since January."* recordings download --since-time 2026-01-01 --until-time 2026-10-10 --output-dir ./zoom-archive --jsonl downloads video, audio, transcripts and chat with SHA-256 manifests; recordings schedule runs it daily.

More: the local archive · search and evidence · Zoom on wirecat.dev

Built for AI agents

• Command line + skill. zm skill install adds the packaged guide for Claude Code, Codex and Gemini CLI. Every command speaks --json or --jsonl, and zm commands --json describes them all.
• MCP. zm personal mcp serve serves zm's commands to Claude Desktop, Cursor and other MCP clients, as far as the profile's permissions allow; zm mcp serve --profiles all serves every profile from one server, and --http serves browser apps behind your tunnel. Connecting a client.

Your agent. Your meetings. Your rules.

More: MCP and skills · connect your AI agent

Why zm

• Context across meetings. Search available hosted meetings and imported transcripts in the shared store. Read archived transcripts separately or import them before searching them together.
• Local-first. Meetings live in a SQLite database on your machine. Archived transcripts can be read and searched offline, without login.
• Every answer has a source. References such as meeting:1/42/57/118 point to one passage of one transcript revision, and corrected transcripts keep their history.
• Made for agents. JSON output, bounded reads with explicit completeness, a skill and an MCP server.
• Safe by default. Your own Zoom app, tokens only in the keyring, permissions per profile, and every change to Zoom asks first at the terminal. Over MCP there is no terminal, so ask runs without a question; use deny or readonly to stop a change.

More: security · Zoom on wirecat.dev

What works today, and what does not yet

zm is at version 0.x; commands may still change. Today it reads hosted meetings, participants, transcripts and AI summaries available to the account through Zoom's official API, imports downloaded WebVTT files, archives cloud recordings, transcribes local audio with an installed speech model, links meetings to events and people, and creates, changes or cancels simple meetings.

• It does not find commitments on its own. Your agent finds them in transcripts; task-proposal only previews a task and creates nothing.
• People are linked by hand. zm never guesses a person from a speaker name; person context covers participants already linked to a person, for example with meetings link.
• Local transcription needs `ffmpeg` for anything but a ready WAV, and a model you download with zm models download; speakers stay unknown.
• Attended meetings need a manual download from your Zoom portal, then zm personal meetings import.
• A company-managed Zoom account may need an admin to approve your app.
• Daily archive jobs install only on Linux. Other platforms can preview them.
• Zoom only, for now. Google Meet and Microsoft Teams are on the roadmap.

More: what is planned · Zoom on wirecat.dev

More: compared with other tools · on wirecat.dev

Commands by task

Zoom meeting changes, links, transcription, schedules, explicit meetings embeddings generation and lock recovery preview by default and run once with --yes; --dry-run keeps the preview. Word search updates its index automatically. Search with --model generates missing vectors before ranking; an explicitly selected remote embedding endpoint receives those transcript passages and the query.

More: usage · every command and option · Zoom on wirecat.dev

Your Zoom app and login

zm reads your meetings through Zoom's official API using a configured user-managed Zoom app with Public Client OAuth. Reuse an existing app available to your user or create one. Enable Public Client OAuth, copy its Public Client ID, configure the redirect and add the required scopes manually. The optional starter manifest supplies neither scopes nor Public Client OAuth. Zoom may show a Client Secret, but zm does not use it. Recording archives and management need additional scopes. Follow the app setup guide; no credentials file is downloaded.

zm personal session start opens Zoom's consent page. Zoom redirects to the static page https://wirecat.dev/zoom-callback, which passes the answer to a listener on your machine; if it cannot, paste the `code=…&state=…