Skip to main content

​
At a glance

  • Availability: Experimental (how to enable).
  • Authentication: OAuth 2.0.
  • Connection: A user authorizes the connection in the provider’s consent screen.
  • Scopes: user:read:user, meeting:read:meeting, meeting:read:list_meetings, meeting:write:meeting, cloud_recording:read:list_user_recordings.
  • Provider documentation: Authentication reference.

​
Credentials

Set these per environment. See Connect an integration. These variables are required only when you supply your own OAuth app. If a managed app is available, you can connect without setting them. Provider permissions and consent still apply.

​
Setup

  1. Create a Zoom app: Sign in at https://marketplace.zoom.us/ (a free Zoom account works) and choose Develop → Build App → General App (user-managed).
  2. Configure the redirect URL: In the app’s OAuth settings, set the OAuth Redirect URL to your app URL ending in /api/auth/zoom/callback and add it to the allow list.
  3. Add scopes: Under Scopes, add the granular scopes user:read:user, meeting:read:meeting, meeting:read:list_meetings, meeting:write:meeting, and cloud_recording:read:list_user_recordings.
  4. Copy credentials and verify: Copy the Client ID and Client Secret into ZOOM_CLIENT_ID and ZOOM_CLIENT_SECRET, connect your account, and run the Get My Profile tool.

​
Provider notes

  • The token endpoint authenticates the client with HTTP Basic (base64 of client_id:client_secret)
  • Access tokens expire after 1 hour; refresh tokens are issued and expire after 90 days
  • Apps created since 2024 use granular scopes (e.g. meeting:read:list_meetings) instead of classic scopes like meeting:read
Provider API reference.

​
Tools

​
Verify the connection

Call a read tool such as zoom__list_meetings with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.