Zoom Automation via Rube MCP

Automate Zoom operations including meeting scheduling, webinar management, cloud recording retrieval, participant tracking, and usage reporting through Composio's Zoom toolkit.

Toolkit docs: composio.dev/toolkits/zoom

Prerequisites

• Rube MCP must be connected (RUBE_SEARCH_TOOLS available)

• Active Zoom connection via RUBE_MANAGE_CONNECTIONS with toolkit zoom

• Always call RUBE_SEARCH_TOOLS first to get current tool schemas

• Most features require a paid Zoom account (Pro plan or higher)

Setup

Get Rube MCP: Add https://rube.app/mcp as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.

• Verify Rube MCP is available by confirming RUBE_SEARCH_TOOLS responds

• Call RUBE_MANAGE_CONNECTIONS with toolkit zoom

• If connection is not ACTIVE, follow the returned auth link to complete Zoom OAuth

• Confirm connection status shows ACTIVE before running any workflows

Core Workflows

1. Create and Schedule Meetings

When to use: User wants to create a new Zoom meeting with specific time, duration, and settings

Tool sequence:

• ZOOM_GET_USER

• Verify authenticated user and check license type [Prerequisite]

• ZOOM_CREATE_A_MEETING

• Create the meeting with topic, time, duration, and settings [Required]

• ZOOM_GET_A_MEETING

• Retrieve full meeting details including join_url [Optional]

• ZOOM_UPDATE_A_MEETING

• Modify meeting settings or reschedule [Optional]

• ZOOM_ADD_A_MEETING_REGISTRANT

• Register participants for registration-enabled meetings [Optional]

Key parameters:

• userId : Always use "me" for user-level apps

• topic : Meeting subject line

• type : 1 (instant), 2 (scheduled), 3 (recurring no fixed time), 8 (recurring fixed time)

• start_time : ISO 8601 format (yyyy-MM-ddTHH:mm:ssZ for UTC or yyyy-MM-ddTHH:mm:ss with timezone field)

• timezone : Timezone ID (e.g., "America/New_York" )

• duration : Duration in minutes

• settings__auto_recording : "none" , "local" , or "cloud"

• settings__waiting_room : Boolean to enable waiting room

• settings__join_before_host : Boolean (disabled when waiting room is enabled)

• settings__meeting_invitees : Array of invitee objects with email addresses

Pitfalls:

• start_time must be in the future; Zoom stores and returns times in UTC regardless of input timezone

• If no start_time is set for type 2 , it becomes an instant meeting that expires after 30 days

• The join_url for participants and start_url for host come from the create response - persist these

• start_url expires in 2 hours (or 90 days for custCreate users)

• Meeting creation is rate-limited to 100 requests/day

• Setting names use double underscores for nesting (e.g., settings__host_video )

2. List and Manage Meetings

When to use: User wants to view upcoming, live, or past meetings

Tool sequence:

• ZOOM_LIST_MEETINGS

• List meetings by type (scheduled, live, upcoming, previous) [Required]

• ZOOM_GET_A_MEETING

• Get detailed info for a specific meeting [Optional]

• ZOOM_UPDATE_A_MEETING

• Modify meeting details [Optional]

Key parameters:

• userId : Use "me" for authenticated user

• type : "scheduled" (default), "live" , "upcoming" , "upcoming_meetings" , "previous_meetings"

• page_size : Records per page (default 30)

• next_page_token : Pagination token from previous response

• from / to : Date range filters

Pitfalls:

• ZOOM_LIST_MEETINGS excludes instant meetings and only shows unexpired scheduled meetings

• For past meetings, use type: "previous_meetings"

• Pagination: always follow next_page_token until empty to get complete results

• Token expiration: next_page_token expires after 15 minutes

• Meeting IDs can exceed 10 digits; store as long integers, not standard integers

3. Manage Recordings

When to use: User wants to list, retrieve, or delete cloud recordings

Tool sequence:

• ZOOM_LIST_ALL_RECORDINGS

• List all cloud recordings for a user within a date range [Required]

• ZOOM_GET_MEETING_RECORDINGS

• Get recordings for a specific meeting [Optional]

• ZOOM_DELETE_MEETING_RECORDINGS

• Move recordings to trash or permanently delete [Optional]

• ZOOM_LIST_ARCHIVED_FILES

• List archived meeting/webinar files [Optional]

Key parameters:

• userId : Use "me" for authenticated user

• from / to : Date range in yyyy-mm-dd format (max 1 month range)

• meetingId : Meeting ID or UUID for specific recording retrieval

• action : "trash" (recoverable) or "delete" (permanent) for deletion

• include_fields : Set to "download_access_token" to get JWT for downloading recordings

• trash : Set true to list recordings from trash

Pitfalls:

• Date range maximum is 1 month; API auto-adjusts from if range exceeds this

• Cloud Recording must be enabled on the account

• UUIDs starting with / or containing // must be double URL-encoded

• ZOOM_DELETE_MEETING_RECORDINGS defaults to "trash" action (recoverable); "delete" is permanent

• Download URLs require the OAuth token in the Authorization header for passcode-protected recordings

• Requires Pro plan or higher

4. Get Meeting Participants and Reports

When to use: User wants to see who attended a past meeting or get usage statistics

Tool sequence:

• ZOOM_GET_PAST_MEETING_PARTICIPANTS

• List attendees of a completed meeting [Required]

• ZOOM_GET_A_MEETING

• Get meeting details and registration info for upcoming meetings [Optional]

• ZOOM_GET_DAILY_USAGE_REPORT

• Get daily usage statistics (meetings, participants, minutes) [Optional]

• ZOOM_GET_A_MEETING_SUMMARY

• Get AI-generated meeting summary [Optional]

Key parameters:

• meetingId : Meeting ID (latest instance) or UUID (specific occurrence)

• page_size : Records per page (default 30)

• next_page_token : Pagination token for large participant lists

Pitfalls:

• ZOOM_GET_PAST_MEETING_PARTICIPANTS only works for completed meetings on paid plans

• Solo meetings (no other participants) return empty results

• UUID encoding: UUIDs starting with / or containing // must be double-encoded

• Always paginate with next_page_token until empty to avoid dropping attendees

• ZOOM_GET_A_MEETING_SUMMARY requires a paid plan with AI Companion enabled; free accounts get 400 errors

• ZOOM_GET_DAILY_USAGE_REPORT has a Heavy rate limit; avoid frequent calls

5. Manage Webinars

When to use: User wants to list webinars or register participants for webinars

Tool sequence:

• ZOOM_LIST_WEBINARS

• List scheduled or upcoming webinars [Required]

• ZOOM_GET_A_WEBINAR

• Get detailed webinar information [Optional]

• ZOOM_ADD_A_WEBINAR_REGISTRANT

• Register a participant for a webinar [Optional]

Key parameters:

• userId : Use "me" for authenticated user

• type : "scheduled" (default) or "upcoming"

• page_size : Records per page (default 30)

• next_page_token : Pagination token

Pitfalls:

• Webinar features require Pro plan or higher with Webinar add-on

• Free/basic accounts cannot use webinar tools

• Only shows unexpired webinars

• Registration must be enabled on the webinar for ZOOM_ADD_A_WEBINAR_REGISTRANT to work

Common Patterns

ID Resolution

• User ID: Always use "me" for user-level apps to refer to the authenticated user

• Meeting ID: Numeric ID (store as long integer); use for latest instance

• Meeting UUID: Use for specific occurrence of recurring meetings; double-encode if starts with / or contains //

• Occurrence ID: Use with recurring meetings to target a specific occurrence

Pagination

Most Zoom list endpoints use token-based pagination:

• Follow next_page_token until it is empty or missing

• Token expires after 15 minutes

• Set explicit page_size (default 30, varies by endpoint)

• Do not use page_number (deprecated on many endpoints)

Time Handling

• Zoom stores all times in UTC internally

• Provide timezone field alongside start_time for local time input

• Use ISO 8601 format: yyyy-MM-ddTHH:mm:ssZ (UTC) or yyyy-MM-ddTHH:mm:ss (with timezone field)

• Date-only fields use yyyy-mm-dd format

Known Pitfalls

Plan Requirements

• Most recording and participant features require Pro plan or higher

• Webinar features require Webinar add-on

• AI meeting summaries require AI Companion feature enabled

• Archived files require "Meeting and Webinar Archiving" enabled by Zoom Support

Rate Limits

• Meeting creation: 100 requests/day, 100 updates per meeting in 24 hours

• ZOOM_GET_PAST_MEETING_PARTICIPANTS : Moderate throttle; add delays for batch processing

• ZOOM_GET_DAILY_USAGE_REPORT : Heavy rate limit

• ZOOM_GET_A_MEETING , ZOOM_GET_MEETING_RECORDINGS : Light rate limit

• ZOOM_LIST_MEETINGS , ZOOM_LIST_ALL_RECORDINGS : Medium rate limit

Parameter Quirks

• Nested settings use double underscore notation (e.g., settings__waiting_room )

• start_url expires in 2 hours; renew via API if needed

• join_before_host is automatically disabled when waiting_room is true

• Recurring meeting fields (recurrence__* ) only apply to type 3 and 8

• password field has max 10 characters with alphanumeric and @ , - , _ , * only

Quick Reference

Task Tool Slug Key Params

Create meeting ZOOM_CREATE_A_MEETING

userId , topic , start_time , type

Get meeting details ZOOM_GET_A_MEETING

meetingId

Update meeting ZOOM_UPDATE_A_MEETING

meetingId , fields to update

List meetings ZOOM_LIST_MEETINGS

userId , type , page_size

Get user info ZOOM_GET_USER

userId

List recordings ZOOM_LIST_ALL_RECORDINGS

userId , from , to

Get recording ZOOM_GET_MEETING_RECORDINGS

meetingId

Delete recording ZOOM_DELETE_MEETING_RECORDINGS

meetingId , action

Past participants ZOOM_GET_PAST_MEETING_PARTICIPANTS

meetingId , page_size

Daily usage report ZOOM_GET_DAILY_USAGE_REPORT

date params

Meeting summary ZOOM_GET_A_MEETING_SUMMARY

meetingId

List webinars ZOOM_LIST_WEBINARS

userId , type

Get webinar ZOOM_GET_A_WEBINAR

webinar ID

Register for meeting ZOOM_ADD_A_MEETING_REGISTRANT

meetingId , participant details

Register for webinar ZOOM_ADD_A_WEBINAR_REGISTRANT

webinar ID, participant details

List archived files ZOOM_LIST_ARCHIVED_FILES

from , to

Powered by Composio