/zoom-skills

Name

zoom-skills

Description

|

# Zoom Developer Platform Skills

This repository contains skills for building with Zoom SDKs, APIs, MCP servers, and integrations across web, mobile, desktop, and server environments.

## Repo Notes

- [general/references/sdk-upgrade-workflow.md](general/references/sdk-upgrade-workflow.md) - reusable changelog + RSS version-by-version SDK upgrade workflow
- Repository-level tooling, plugin manifests, and maintenance docs live at the packaging root; raw-skill installs should treat this `skills/` tree as the portable boundary.

## Folder Structure

| Folder | Description |
|--------|-------------|
| **[zoom-general](general/SKILL.md)** | **Hub** - Cross-product use cases and shared references |
| **[zoom-rest-api](rest-api/SKILL.md)** | REST API calls (600+ endpoints) |
| **[zoom-webhooks](webhooks/SKILL.md)** | Real-time event notifications (HTTP) |
| **[zoom-websockets](websockets/SKILL.md)** | Real-time event notifications (WebSocket) |
| **[zoom-meeting-sdk](meeting-sdk/SKILL.md)** | Embed Zoom meetings in your app (Web, React Native, Electron, Linux) |
| **[zoom-video-sdk](video-sdk/SKILL.md)** | Custom video experiences (Web, React Native, Flutter, Android, iOS, macOS, Unity, Linux) |
| **[zoom-plugin-sdk](plugin-sdk/SKILL.md)** | Native macOS/Windows companion apps that control the installed Zoom Workplace client over IPC |
| **[zoom-apps-sdk](zoom-apps-sdk/SKILL.md)** | Apps that run inside the Zoom client |
| **[scribe](scribe/SKILL.md)** | Zoom AI Services Scribe for synchronous and batch transcription of uploaded or stored media |
| **[summarizer](summarizer/SKILL.md)** | Zoom AI Services Summarizer for transcript recaps, summaries, and action items |
| **[translator](translator/SKILL.md)** | Zoom AI Services Translator for plain-text and batch file translation |
| **[zoom-rtms](rtms/SKILL.md)** | Real-Time Media Streams (live audio/video/transcripts) |
| **[zoom-team-chat](team-chat/SKILL.md)** | Team Chat messaging and channels |
| **[virtual-agent](virtual-agent/SKILL.md)** | Virtual Agent web/mobile chat embeds and KB sync workflows |
| **[contact-center](contact-center/SKILL.md)** | Contact Center apps, web embeds, and native mobile SDK integrations |
| **[phone](phone/SKILL.md)** | Zoom Phone APIs, Smart Embed, URI schemes, webhooks, and call-history migration patterns |
| **[rivet-sdk](rivet-sdk/SKILL.md)** | Rivet JavaScript server framework for OAuth, webhook events, and typed API endpoint wrappers |
| **[probe-sdk](probe-sdk/SKILL.md)** | Browser/device/network readiness diagnostics before Meeting SDK or Video SDK join flows |
| **[zoom-ui-toolkit](ui-toolkit/SKILL.md)** | Pre-built React components for Video SDK |
| **[zoom-cobrowse-sdk](cobrowse-sdk/SKILL.md)** | Collaborative browsing for support |
| **[zoom-oauth](oauth/SKILL.md)** | OAuth authentication flows (all 4 grant types) |
| **[zoom-mcp](zoom-mcp/SKILL.md)** | Parent router for the unified Zoom MCP Server and dedicated product MCP servers |
| **[zoom-mcp/whiteboard](zoom-mcp/whiteboard/SKILL.md)** | Whiteboard creation, retrieval, and collaborator tools |
| **[zoom-mcp/team-chat](zoom-mcp/team-chat/SKILL.md)** | Team Chat message, file, contact, session, channel, and member tools |
| **[zoom-mcp/meetings](zoom-mcp/meetings/SKILL.md)** | Meeting search, assets, recordings, and recording resources |
| **[zoom-mcp/canvas](zoom-mcp/canvas/SKILL.md)** | Canvas file, block, collaborator, and content tools |
| **[zoom-mcp/tasks](zoom-mcp/tasks/SKILL.md)** | Task, comment, assignee, collaborator, and step tools |
| **[zoom-mcp/revenue-accelerator](zoom-mcp/revenue-accelerator/SKILL.md)** | ZRA conversation intelligence, deals, customers, and coaching data |

## How to Use

1. **Product-specific task?** → Go to that product's folder (e.g., `meeting-sdk/`)
2. **Cross-product or general task?** → Check [zoom-general](general/SKILL.md) for generic use cases
3. **Each folder has a `SKILL.md`** → Start there for that product's overview

**Marketplace prerequisite:** Many product skills need a Zoom Marketplace app before
their credentials, scopes, webhooks, or SDK keys exist. When a task starts with app
creation, app type selection, manifest validation, scopes, event subscriptions, or
credential retrieval, route first to
[Marketplace app management](rest-api/references/marketplace-apps.md), then return to
the product skill.
For automated selection, read the
[Marketplace template index](rest-api/assets/marketplace-apps/marketplace-manifest-template-index.json).
Use the [manifest update workflow](rest-api/references/marketplace-manifest-update-workflow.md)
for existing General Apps; S2S and Meeting SDK entries are create requests, not General App manifests.
For external REST/MCP connectors and manifest-managed actions or triggers, merge the appropriate
[feature fragment](rest-api/references/marketplace-connect-actions-triggers.md) into a complete
General App manifest. This is distinct from configuring OAuth for Zoom-hosted MCP servers.

## Skill Discovery (Integrated)

This repo uses progressive discovery:
- Agent reads `SKILL.md` frontmatter first (`name`, `description`, optional `triggers`).
- Agent routes by intent using `general/SKILL.md` "Choose Your Path" plus keyword/trigger matching.
- Agent loads full skill content only after route selection.

To improve routing quality in any skill:
- Keep `description` specific and keyword-rich (include "use when...").
- Add practical `triggers` for common user phrasing.
- Avoid overlapping triggers between Meeting SDK, Video SDK, REST API, and MCP intents.

## zoom-general (Hub)

The `zoom-general` folder contains:

- **Cross-product use cases** - Tasks that span multiple Zoom products
- **Generic references** - Authentication, app types, scopes
- **Shared documentation** - SDK maintenance, troubleshooting, marketplace publishing

Use `zoom-general` when:
- You're starting a new Zoom integration and need to choose the right approach
- Your use case involves multiple Zoom products
- You need general platform documentation (auth, scopes, etc.)

## Quick Reference

| I want to... | Use this skill |
|--------------|----------------|
| Build deterministic automation/configuration/reporting with explicit request control | **zoom-rest-api** |
| Create or update Marketplace manifests, Connect routes, actions, or triggers | **zoom-rest-api** |
| Receive event notifications (HTTP push) | **zoom-webhooks** |
| Receive event notifications (WebSocket) | **zoom-websockets** |
| Embed Zoom meetings in my app | **zoom-meeting-sdk** |
| Build custom video experiences | **zoom-video-sdk** |
| Control the installed Zoom Workplace client from a native desktop app | **zoom-plugin-sdk** |
| Build an app inside Zoom client | **zoom-apps-sdk** |
| Access live audio/video/transcripts | **zoom-rtms** |
| Transcribe uploaded or stored media files into text | **scribe** |
| Summarize transcript text into recaps, summaries, or action items | **summarizer** |
| Translate plain text or stored text files | **translator** |
| Build Team Chat integrations | **zoom-team-chat** |
| Build Virtual Agent chat/campaign experiences | **virtual-agent** |
| Build Contact Center integrations (apps/web/mobile) | **contact-center** |
| Build Zoom Phone integrations (Smart Embed, APIs, webhooks, URI launch) | **phone** |
| Build Rivet-based server integrations (optional) | **rivet-sdk** |
| Run browser/device/network preflight diagnostics before join | **probe-sdk** |
| Use pre-built video UI components | **zoom-ui-toolkit** |
| Enable co-browsing for support | **zoom-cobrowse-sdk** |
| Implement OAuth authentication | **zoom-oauth** |
| Build AI-driven meeting search, meeting-asset retrieval, recording-resource retrieval, or Zoom Canvas workflows | **zoom-mcp** |
| Search, send, edit, or administer Zoom Team Chat through MCP tools | **zoom-mcp/team-chat** |
| Manage Zoom Canvas files, blocks, collaborators, or sharing through MCP | **zoom-mcp/canvas** |
| Manage Zoom Tasks through MCP tools | **zoom-mcp/tasks** |
| Retrieve ZRA conversation and deal intelligence through MCP | **zoom-mcp/revenue-accelerator** |
| Build enterprise AI workflows with stable API core + AI tool layer | **zoom-rest-api + zoom-mcp** |
| General/cross-product guidance | **zoom-general** |

## APIs vs MCP Routing (Official Zoom Guidance)

| Primary goal | Route |
|--------------|-------|
| Automation, configuration, reporting, scheduled jobs, strict retries/error control | **zoom-rest-api** |
| AI interaction, dynamic tool discovery, cross-platform AI workflows | **zoom-mcp** |
| Enterprise AI experiences at scale | **zoom-rest-api + zoom-mcp** |

Source: https://developers.zoom.us/docs/mcp/apis-vs-mcp/
- Deep dive: [general/use-cases/apis-vs-mcp-routing.md](general/use-cases/apis-vs-mcp-routing.md)
- MCP transport note: Zoom's current hosted MCP catalog uses Streamable HTTP (client support required).

### MCP Server Model (Zoom-Hosted)

- Zoom acts as MCP server and exposes Zoom platform tools/data to external AI clients.
- MCP access is OAuth-scoped and governed.
- The current product-scoped MCP servers are Meetings, Chat, Canvas, Tasks, Whiteboard, and
  Revenue Accelerator. The unified Zoom MCP Server is a separate all-in-one surface.
- Use `zoom-mcp` as the parent entry point, then chain Marketplace app creation -> user OAuth
  token acquisition -> the product-specific MCP child skill. Select the matching app template
  from [Marketplace app templates](rest-api/references/marketplace-app-templates.md).

## Resources

- **Official docs**: https://developers.zoom.us/
- **Marketplace**: https://marketplace.zoom.us/
- **Developer forum**: https://devforum.zoom.us/

## Operations

- Use the product `RUNBOOK.md` files inside each skill directory for runtime/debugging guidance during raw-skill installs.