DOCUMENTATION / GETTING STARTED

Build and manage Zoom Marketplace apps from your coding client.

App builder for agents is an OAuth-powered MCP service for Codex, Claude Code, and other compatible AI coding clients. It helps authorized Zoom account administrators inspect and manage Marketplace app configurations.

PLUGIN + MCP QUICKSTART

Sideload the Zoom plugin, then connect App builder for agents.

The Zoom plugin supplies product knowledge and app-building workflows. App builder for agents supplies the authenticated tools that read, create, validate, update, and delete apps in the authorized Zoom account. Use the repository built for your coding client; the two packages are not interchangeable.

Prerequisites

No paid Zoom plan is required for the basic General App workflow. Individual Zoom products and app features may require additional licenses or account permissions.

  1. Clone the Codex plugin locally.
    git clone https://github.com/zoom/zoom-plugin-codex.git \
      "$HOME/zoom-plugin-codex"
  2. Register the cloned directory as a local marketplace.
    codex plugin marketplace add \
      "$HOME/zoom-plugin-codex"
  3. Install the locally sideloaded Zoom plugin.
    codex plugin add zoom@zoom-local
  4. Add App builder for agents as a remote MCP server.
    codex mcp add zoom-marketplace-helper \
      --url https://marketplacehelper.asdc.cc/mcp \
      --oauth-resource https://marketplacehelper.asdc.cc/mcp
  5. Start OAuth and request the helper scopes.
    codex mcp login zoom-marketplace-helper \
      --scopes marketplace:read,marketplace:write,offline_access

This is a local sideload. Start a new Codex session after installation so plugin skills and commands reload.

CLAUDE CODE zoom/zoom-plugin
  1. Clone the Claude plugin locally for sideloading.
    git clone https://github.com/zoom/zoom-plugin.git \
      "$HOME/zoom-plugin"
  2. Add App builder for agents to Claude Code.
    claude mcp add --transport http --scope user \
      zoom-marketplace-helper \
      https://marketplacehelper.asdc.cc/mcp
  3. Sideload the plugin when launching Claude Code.
    claude --plugin-dir "$HOME/zoom-plugin"
  4. Approve the MCP connection and complete OAuth when Claude prompts.

    Use /mcp inside Claude Code if the authorization prompt does not open automatically.

This loads the plugin for that Claude session only. Repeat --plugin-dir when starting another session.

Before installing

These instructions intentionally use local sideloading rather than a published plugin catalog. Review each repository and its permissions, and run the commands only in an environment where you trust the source.

What happens during OAuth

  1. 01
    Your coding client contacts App builder for agents.

    Codex or Claude connects to Loading service URL… and reads its OAuth discovery metadata.

  2. 02
    App builder for agents starts authorization.

    The service opens its authorization route and securely tracks the client callback, PKCE challenge, requested scopes, and state.

  3. 03
    Your browser is redirected to Zoom.

    Zoom authorization uses the registered production callback shown below.

  4. 04
    Zoom returns to App builder for agents.

    The service exchanges Zoom's code server-side, encrypts the Zoom token set, and redirects an MCP authorization code to the temporary loopback callback opened by Codex or Claude.

  5. 05
    The MCP tools become available.

    The plugin's skill selects the app model and manifest while App builder for agents performs the authorized Marketplace operations.

https://zoom.us/oauth/authorize?response_type=code&client_id=ppZXdcR5Q1aih7ZViaGQdQ&redirect_uri=https://marketplacehelper.asdc.cc/oauth/callback

Do not configure the Zoom callback above as the coding client's MCP callback. App builder for agents owns that callback; Codex and Claude use their temporary localhost callback automatically.

Try your first request

Start with a clear app goal and ask the plugin to gather any missing settings before making changes:

I want to create a Zoom Marketplace app for a Team Chat integration. Ask me for any required choices, build and validate the manifest, then create the app and return its app ID.

Use the Marketplace tools

List and inspect apps

Ask the agent to list the Marketplace apps accessible to the account, then provide an app ID to retrieve its metadata or export its manifest. Unpublished developer drafts may be absent from list results, so use the exact app ID returned when the draft was created.

Create an app

Ask the agent to create a General App or Server-to-Server OAuth app and provide its intended authorization level, Zoom products, HTTPS URLs, scopes, and features. General App manifests are validated before creation. Meeting SDK is configured as a capability of a General App rather than as a standalone app type.

Update an app

  1. Export the current manifest using the exact app ID.
  2. Change only the intended settings.
  3. Validate the complete replacement manifest with the app ID.
  4. Apply the update and export the manifest again to verify the result.

Manifest updates replace the complete configuration, so exporting first prevents unrelated fields from being omitted.

Delete an app

Provide the exact app ID and explicitly confirm deletion. The helper deletes the app and verifies that Zoom no longer returns it. Deleting an app is permanent and is separate from removing App builder for agents from the Zoom account.

Connection reference

The remote MCP endpoint and OAuth discovery documents are:

Authorization

The MCP client starts an OAuth authorization flow. You authorize the Zoom account in the browser, and the helper stores the Zoom token in an encrypted local SQLite database. The raw Zoom access token is not returned in the browser callback.

The helper MCP scopes are:

Available tools

Important workflows

Validate a General App manifest before creating or replacing it. Export the current manifest before updating so fields that should remain unchanged are preserved.

Marketplace list results may not include unpublished developer drafts. Keep the exact app_id returned by creation for later reads, updates, or deletion.

Remove App builder for agents

To revoke the integration from your Zoom account:

  1. Sign in to the Zoom App Marketplace.
  2. In the upper-right corner, select Manage.
  3. In the left navigation, select Added Apps.
  4. Find and select App builder for agents.
  5. Select Remove, optionally provide a reason, and confirm removal.

Removal revokes the integration's access to your Zoom account, so existing Codex and Claude MCP sessions can no longer perform Marketplace operations. Marketplace apps previously created or updated through the helper remain in your Zoom account and are not deleted automatically.

After Zoom confirms removal, the service deletes and no longer retains the matching installation record, encrypted Zoom access and refresh tokens, helper MCP access and refresh tokens, and pending authorization codes. Once cleanup completes, the service has no active credentials for the removed connection and can no longer access the Zoom account. These records are not kept for analytics, advertising, profiling, or future reuse, and Marketplace API responses are not retained in a separate content or analytics database.

Optionally remove the now-unusable MCP server registration from your coding client:

# Codex
codex mcp remove zoom-marketplace-helper

# Claude Code
claude mcp remove --scope user zoom-marketplace-helper

Removing the MCP registration or sideloaded plugin alone does not revoke Zoom authorization. Complete the Zoom App Marketplace removal steps above to disconnect the account and trigger server-side cleanup.

Troubleshooting

OAuth does not open

Run the MCP login command again. In Claude Code, use /mcp and select the server to begin authorization.

Authorization is rejected

Confirm that the Zoom user can manage Marketplace apps and that the requested permissions were approved.

MCP tools are missing

Restart the coding client after sideloading, then confirm that zoom-marketplace-helper is in its MCP server list.

A draft is absent from list results

Use the exact app ID returned during creation; Zoom may omit developer-owned unpublished drafts from list results.

Manifest validation returns ok:false

Correct the referenced field-level errors and validate again. An HTTP success response does not mean the manifest is valid.

The connection stopped after removal

Add the MCP server again and complete Zoom OAuth to establish a new authorized connection.

Data protection

The service stores OAuth access and refresh tokens, account identifiers, granted scopes, and limited integration metadata in a private SQLite database on the application host. The application state is encrypted with AES-256-GCM, the database file is restricted to the service account, and the underlying storage is encrypted. Raw Zoom OAuth tokens are not returned to MCP clients, browsers, or application logs.

Architecture diagram

These files describe the deployed service architecture, OAuth sequence, Marketplace management flow, and current security and storage boundaries.

Application icons

Marketplace-ready 512x512 PNG icons. Each file is larger than 160x160 and below the 1 MB limit.

Cover image

Marketplace-ready text-light PNG cover image at the required 1824x176 resolution and below 2 MB.

Download the cover image

App gallery screenshots

Example CLI workflows showing Claude Code and Codex using the App builder for agents MCP service to create a Team Chat app.

Support

For installation, authorization, removal, or Marketplace configuration help, submit the support request form. Do not include OAuth tokens, client secrets, signing secrets, or other credentials in a request.

Open support form