zoom-agent-cli: Instructions file for Codex

zoom-agent-cli — AI Agent Guide

Requires Node 18+. Install with npm install -g zoom-agent-cli or run npx zoom-agent-cli. From a clone: npm install && npm run build. Upgrade from 0.1.x with npm install -g zoom-agent-cli@latest — older npm builds 404 on transcripts.

Quick Start (No Browser Needed)

# Set credentials via environment variables
export ZOOM_ACCOUNT_ID="your-account-id"
export ZOOM_CLIENT_ID="your-client-id"
export ZOOM_CLIENT_SECRET="your-client-secret"

# Test connectivity
zoom status

# List upcoming meetings
zoom meetings list --user-id me --type upcoming --pretty

# Pull a cloud recording VTT (Zoom has no standalone transcript endpoint)
zoom recordings recent --days 14 --pretty
zoom recordings transcript <meetingId>

MCP Server Setup

Add to Grok (~/.grok/config.toml):

[mcp_servers.zoom]
command = "zoom"
args = ["mcp"]
enabled = true

Credentials come from zoom login (~/.zoom-agent-cli/config.json) or ZOOM_ACCOUNT_ID / ZOOM_CLIENT_ID / ZOOM_CLIENT_SECRET.

Add to Claude (~/.claude.json):

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

Or if installed globally (npm install -g zoom-agent-cli):

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

Authentication

Three-tier credential resolution (checked in order):

1. CLI flags: --account-id, --client-id, --client-secret
2. Environment variables: ZOOM_ACCOUNT_ID, ZOOM_CLIENT_ID, ZOOM_CLIENT_SECRET
3. Stored config: ~/.zoom-agent-cli/config.json (created via zoom login)