zoom-automation
Compare original and translation side by side
🇺🇸
Original
English🇨🇳
Translation
ChineseZoom Automation via Rube MCP
通过Rube MCP实现Zoom自动化
Automate Zoom operations including meeting scheduling, webinar management, cloud recording retrieval, participant tracking, and usage reporting through Composio's Zoom toolkit.
借助Composio的Zoom工具包,自动化Zoom操作,包括会议调度、网络研讨会管理、云录制检索、参会者追踪以及使用情况报告。
Prerequisites
前提条件
- Rube MCP must be connected (RUBE_SEARCH_TOOLS available)
- Active Zoom connection via with toolkit
RUBE_MANAGE_CONNECTIONSzoom - Always call first to get current tool schemas
RUBE_SEARCH_TOOLS - Most features require a paid Zoom account (Pro plan or higher)
- 必须已连接Rube MCP(需确保可用)
RUBE_SEARCH_TOOLS - 通过并使用工具包
RUBE_MANAGE_CONNECTIONS完成Zoom的激活连接zoom - 请始终先调用以获取最新的工具架构
RUBE_SEARCH_TOOLS - 大多数功能需要付费Zoom账户(Pro版或更高等级)
Setup
设置步骤
Get Rube MCP: Add as an MCP server in your client configuration. No API keys needed — just add the endpoint and it works.
https://rube.app/mcp- Verify Rube MCP is available by confirming responds
RUBE_SEARCH_TOOLS - Call with toolkit
RUBE_MANAGE_CONNECTIONSzoom - If connection is not ACTIVE, follow the returned auth link to complete Zoom OAuth
- Confirm connection status shows ACTIVE before running any workflows
获取Rube MCP:在客户端配置中添加作为MCP服务器。无需API密钥——只需添加端点即可使用。
https://rube.app/mcp- 确认能正常响应,以此验证Rube MCP是否可用
RUBE_SEARCH_TOOLS - 调用并指定工具包
RUBE_MANAGE_CONNECTIONSzoom - 如果连接状态未显示为ACTIVE,请按照返回的认证链接完成Zoom OAuth授权
- 在运行任何工作流之前,确认连接状态显示为ACTIVE
Core Workflows
核心工作流
1. Create and Schedule Meetings
1. 创建与调度会议
When to use: User wants to create a new Zoom meeting with specific time, duration, and settings
Tool sequence:
- - Verify authenticated user and check license type [Prerequisite]
ZOOM_GET_USER - - Create the meeting with topic, time, duration, and settings [Required]
ZOOM_CREATE_A_MEETING - - Retrieve full meeting details including join_url [Optional]
ZOOM_GET_A_MEETING - - Modify meeting settings or reschedule [Optional]
ZOOM_UPDATE_A_MEETING - - Register participants for registration-enabled meetings [Optional]
ZOOM_ADD_A_MEETING_REGISTRANT
Key parameters:
- : Always use
userIdfor user-level apps"me" - : Meeting subject line
topic - :
type(instant),1(scheduled),2(recurring no fixed time),3(recurring fixed time)8 - : ISO 8601 format (
start_timefor UTC oryyyy-MM-ddTHH:mm:ssZwith timezone field)yyyy-MM-ddTHH:mm:ss - : Timezone ID (e.g.,
timezone)"America/New_York" - : Duration in minutes
duration - :
settings__auto_recording,"none", or"local""cloud" - : Boolean to enable waiting room
settings__waiting_room - : Boolean (disabled when waiting room is enabled)
settings__join_before_host - : Array of invitee objects with email addresses
settings__meeting_invitees
Pitfalls:
- must be in the future; Zoom stores and returns times in UTC regardless of input timezone
start_time - If no is set for type
start_time, it becomes an instant meeting that expires after 30 days2 - The for participants and
join_urlfor host come from the create response - persist thesestart_url - expires in 2 hours (or 90 days for
start_urlusers)custCreate - Meeting creation is rate-limited to 100 requests/day
- Setting names use double underscores for nesting (e.g., )
settings__host_video
适用场景:用户需要创建具有特定时间、时长及设置的新Zoom会议
工具执行顺序:
- - 验证已认证用户并检查许可证类型 [前提步骤]
ZOOM_GET_USER - - 创建包含主题、时间、时长及设置的会议 [必需步骤]
ZOOM_CREATE_A_MEETING - - 获取包含join_url在内的完整会议详情 [可选步骤]
ZOOM_GET_A_MEETING - - 修改会议设置或重新调度 [可选步骤]
ZOOM_UPDATE_A_MEETING - - 为启用注册的会议添加参会者 [可选步骤]
ZOOM_ADD_A_MEETING_REGISTRANT
关键参数:
- : 用户级应用请始终使用
userId"me" - : 会议主题
topic - :
type(即时会议)、1(已调度会议)、2(无固定时间的 recurring 会议)、3(固定时间的 recurring 会议)8 - : ISO 8601格式(UTC时间使用
start_time,带时区的时间使用yyyy-MM-ddTHH:mm:ssZ并配合timezone字段)yyyy-MM-ddTHH:mm:ss - : 时区ID(例如
timezone)"America/New_York" - : 会议时长(分钟)
duration - :
settings__auto_recording、"none"或"local""cloud" - : 布尔值,用于启用等候室
settings__waiting_room - : 布尔值(启用等候室时该参数会自动禁用)
settings__join_before_host - : 包含参会者邮箱的对象数组
settings__meeting_invitees
注意事项:
- 必须设置为未来时间;Zoom会将所有时间以UTC格式存储和返回,与输入时区无关
start_time - 如果类型为的会议未设置
2,则会变为即时会议,30天后过期start_time - 参会者的和主持人的
join_url会在创建会议的响应中返回,请妥善保存start_url - 的有效期为2小时(
start_url用户的有效期为90天)custCreate - 会议创建接口的调用频率限制为每天100次
- 嵌套设置项使用双下划线命名(例如)
settings__host_video
2. List and Manage Meetings
2. 会议列表与管理
When to use: User wants to view upcoming, live, or past meetings
Tool sequence:
- - List meetings by type (scheduled, live, upcoming, previous) [Required]
ZOOM_LIST_MEETINGS - - Get detailed info for a specific meeting [Optional]
ZOOM_GET_A_MEETING - - Modify meeting details [Optional]
ZOOM_UPDATE_A_MEETING
Key parameters:
- : Use
userIdfor authenticated user"me" - :
type(default),"scheduled","live","upcoming","upcoming_meetings""previous_meetings" - : Records per page (default 30)
page_size - : Pagination token from previous response
next_page_token - /
from: Date range filtersto
Pitfalls:
- excludes instant meetings and only shows unexpired scheduled meetings
ZOOM_LIST_MEETINGS - For past meetings, use
type: "previous_meetings" - Pagination: always follow until empty to get complete results
next_page_token - Token expiration: expires after 15 minutes
next_page_token - Meeting IDs can exceed 10 digits; store as long integers, not standard integers
适用场景:用户需要查看即将召开、正在进行或已结束的会议
工具执行顺序:
- - 按类型列出会议(已调度、正在进行、即将召开、已结束) [必需步骤]
ZOOM_LIST_MEETINGS - - 获取特定会议的详细信息 [可选步骤]
ZOOM_GET_A_MEETING - - 修改会议详情 [可选步骤]
ZOOM_UPDATE_A_MEETING
关键参数:
- : 已认证用户请使用
userId"me" - :
type(默认)、"scheduled"、"live"、"upcoming"、"upcoming_meetings""previous_meetings" - : 每页记录数(默认30条)
page_size - : 上一次响应返回的分页令牌
next_page_token - /
from: 日期范围过滤器to
注意事项:
- 不包含即时会议,仅显示未过期的已调度会议
ZOOM_LIST_MEETINGS - 查看已结束的会议请使用
type: "previous_meetings" - 分页处理:请始终跟随直到其为空,以获取完整结果
next_page_token - 令牌过期:的有效期为15分钟
next_page_token - 会议ID可能超过10位数字,请以长整数类型存储,而非标准整数
3. Manage Recordings
3. 录制内容管理
When to use: User wants to list, retrieve, or delete cloud recordings
Tool sequence:
- - List all cloud recordings for a user within a date range [Required]
ZOOM_LIST_ALL_RECORDINGS - - Get recordings for a specific meeting [Optional]
ZOOM_GET_MEETING_RECORDINGS - - Move recordings to trash or permanently delete [Optional]
ZOOM_DELETE_MEETING_RECORDINGS - - List archived meeting/webinar files [Optional]
ZOOM_LIST_ARCHIVED_FILES
Key parameters:
- : Use
userIdfor authenticated user"me" - /
from: Date range intoformat (max 1 month range)yyyy-mm-dd - : Meeting ID or UUID for specific recording retrieval
meetingId - :
action(recoverable) or"trash"(permanent) for deletion"delete" - : Set to
include_fieldsto get JWT for downloading recordings"download_access_token" - : Set
trashto list recordings from trashtrue
Pitfalls:
- Date range maximum is 1 month; API auto-adjusts if range exceeds this
from - Cloud Recording must be enabled on the account
- UUIDs starting with or containing
/must be double URL-encoded// - defaults to
ZOOM_DELETE_MEETING_RECORDINGSaction (recoverable);"trash"is permanent"delete" - Download URLs require the OAuth token in the Authorization header for passcode-protected recordings
- Requires Pro plan or higher
适用场景:用户需要列出、检索或删除云录制内容
工具执行顺序:
- - 列出指定日期范围内用户的所有云录制内容 [必需步骤]
ZOOM_LIST_ALL_RECORDINGS - - 获取特定会议的录制内容 [可选步骤]
ZOOM_GET_MEETING_RECORDINGS - - 将录制内容移至回收站或永久删除 [可选步骤]
ZOOM_DELETE_MEETING_RECORDINGS - - 列出已归档的会议/网络研讨会文件 [可选步骤]
ZOOM_LIST_ARCHIVED_FILES
关键参数:
- : 已认证用户请使用
userId"me" - /
from: 日期范围,格式为to(最大范围为1个月)yyyy-mm-dd - : 用于检索特定录制内容的会议ID或UUID
meetingId - : 删除操作类型,
action(可恢复)或"trash"(永久删除)"delete" - : 设置为
include_fields以获取用于下载录制内容的JWT令牌"download_access_token" - : 设置为
trash以列出回收站中的录制内容true
注意事项:
- 日期范围最大为1个月;如果超出该范围,API会自动调整参数
from - 账户必须启用云录制功能
- 以开头或包含
/的UUID必须进行双重URL编码// - 的默认操作是
ZOOM_DELETE_MEETING_RECORDINGS(可恢复);"trash"为永久删除"delete" - 受密码保护的录制内容的下载链接需要在Authorization请求头中携带OAuth令牌
- 需要Pro版或更高等级的账户
4. Get Meeting Participants and Reports
4. 参会者与报告获取
When to use: User wants to see who attended a past meeting or get usage statistics
Tool sequence:
- - List attendees of a completed meeting [Required]
ZOOM_GET_PAST_MEETING_PARTICIPANTS - - Get meeting details and registration info for upcoming meetings [Optional]
ZOOM_GET_A_MEETING - - Get daily usage statistics (meetings, participants, minutes) [Optional]
ZOOM_GET_DAILY_USAGE_REPORT - - Get AI-generated meeting summary [Optional]
ZOOM_GET_A_MEETING_SUMMARY
Key parameters:
- : Meeting ID (latest instance) or UUID (specific occurrence)
meetingId - : Records per page (default 30)
page_size - : Pagination token for large participant lists
next_page_token
Pitfalls:
- only works for completed meetings on paid plans
ZOOM_GET_PAST_MEETING_PARTICIPANTS - Solo meetings (no other participants) return empty results
- UUID encoding: UUIDs starting with or containing
/must be double-encoded// - Always paginate with until empty to avoid dropping attendees
next_page_token - requires a paid plan with AI Companion enabled; free accounts get 400 errors
ZOOM_GET_A_MEETING_SUMMARY - has a Heavy rate limit; avoid frequent calls
ZOOM_GET_DAILY_USAGE_REPORT
适用场景:用户需要查看已结束会议的参会人员或获取使用统计数据
工具执行顺序:
- - 列出已结束会议的参会者 [必需步骤]
ZOOM_GET_PAST_MEETING_PARTICIPANTS - - 获取即将召开会议的详情及注册信息 [可选步骤]
ZOOM_GET_A_MEETING - - 获取每日使用统计数据(会议数量、参会人数、时长) [可选步骤]
ZOOM_GET_DAILY_USAGE_REPORT - - 获取AI生成的会议摘要 [可选步骤]
ZOOM_GET_A_MEETING_SUMMARY
关键参数:
- : 会议ID(最新实例)或UUID(特定场次)
meetingId - : 每页记录数(默认30条)
page_size - : 用于处理大量参会者列表的分页令牌
next_page_token
注意事项:
- 仅适用于付费账户的已结束会议
ZOOM_GET_PAST_MEETING_PARTICIPANTS - 无其他参会者的单人会议会返回空结果
- UUID编码:以开头或包含
/的UUID必须进行双重编码// - 请始终使用进行分页处理,直到其为空,避免遗漏参会者
next_page_token - 需要启用AI Companion功能的付费账户;免费账户调用会返回400错误
ZOOM_GET_A_MEETING_SUMMARY - 的调用频率限制严格,请避免频繁调用
ZOOM_GET_DAILY_USAGE_REPORT
5. Manage Webinars
5. 网络研讨会管理
When to use: User wants to list webinars or register participants for webinars
Tool sequence:
- - List scheduled or upcoming webinars [Required]
ZOOM_LIST_WEBINARS - - Get detailed webinar information [Optional]
ZOOM_GET_A_WEBINAR - - Register a participant for a webinar [Optional]
ZOOM_ADD_A_WEBINAR_REGISTRANT
Key parameters:
- : Use
userIdfor authenticated user"me" - :
type(default) or"scheduled""upcoming" - : Records per page (default 30)
page_size - : Pagination token
next_page_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 to work
ZOOM_ADD_A_WEBINAR_REGISTRANT
适用场景:用户需要列出网络研讨会或为参会者注册网络研讨会
工具执行顺序:
- - 列出已调度或即将召开的网络研讨会 [必需步骤]
ZOOM_LIST_WEBINARS - - 获取网络研讨会的详细信息 [可选步骤]
ZOOM_GET_A_WEBINAR - - 为参会者注册网络研讨会 [可选步骤]
ZOOM_ADD_A_WEBINAR_REGISTRANT
关键参数:
- : 已认证用户请使用
userId"me" - :
type(默认)或"scheduled""upcoming" - : 每页记录数(默认30条)
page_size - : 分页令牌
next_page_token
注意事项:
- 网络研讨会功能需要Pro版或更高等级账户,并添加网络研讨会附加组件
- 免费/基础账户无法使用网络研讨会工具
- 仅显示未过期的网络研讨会
- 只有当网络研讨会启用注册功能时,才能正常工作
ZOOM_ADD_A_WEBINAR_REGISTRANT
Common Patterns
通用模式
ID Resolution
ID解析
- User ID: Always use for user-level apps to refer to the authenticated user
"me" - 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
- 用户ID: 用户级应用请始终使用指代已认证用户
"me" - 会议ID: 数字ID(请以长整数类型存储);用于指向最新的会议实例
- 会议UUID: 用于指向 recurring 会议的特定场次;如果UUID以开头或包含
/,需要进行双重编码// - 场次ID: 用于定位 recurring 会议的特定场次
Pagination
分页处理
Most Zoom list endpoints use token-based pagination:
- Follow until it is empty or missing
next_page_token - Token expires after 15 minutes
- Set explicit (default 30, varies by endpoint)
page_size - Do not use (deprecated on many endpoints)
page_number
大多数Zoom列表类接口使用基于令牌的分页机制:
- 请跟随直到其为空或不存在
next_page_token - 令牌的有效期为15分钟
- 显式设置参数(默认30条,不同接口可能有所不同)
page_size - 请勿使用参数(该参数在许多接口中已被弃用)
page_number
Time Handling
时间处理
- Zoom stores all times in UTC internally
- Provide field alongside
timezonefor local time inputstart_time - Use ISO 8601 format: (UTC) or
yyyy-MM-ddTHH:mm:ssZ(with timezone field)yyyy-MM-ddTHH:mm:ss - Date-only fields use format
yyyy-mm-dd
- Zoom内部所有时间均以UTC格式存储
- 输入本地时间时,请同时提供字段
timezone - 使用ISO 8601格式:(UTC时间)或
yyyy-MM-ddTHH:mm:ssZ(配合timezone字段)yyyy-MM-ddTHH:mm:ss - 仅日期的字段使用格式
yyyy-mm-dd
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
- 大多数录制和参会者相关功能需要Pro版或更高等级账户
- 网络研讨会功能需要网络研讨会附加组件
- AI会议摘要需要启用AI Companion功能
- 归档文件功能需要Zoom支持团队启用“会议与网络研讨会归档”
Rate Limits
调用频率限制
- Meeting creation: 100 requests/day, 100 updates per meeting in 24 hours
- : Moderate throttle; add delays for batch processing
ZOOM_GET_PAST_MEETING_PARTICIPANTS - : Heavy rate limit
ZOOM_GET_DAILY_USAGE_REPORT - ,
ZOOM_GET_A_MEETING: Light rate limitZOOM_GET_MEETING_RECORDINGS - ,
ZOOM_LIST_MEETINGS: Medium rate limitZOOM_LIST_ALL_RECORDINGS
- 会议创建:每天100次请求,每个会议24小时内最多可更新100次
- : 调用频率限制中等;批量处理时请添加延迟
ZOOM_GET_PAST_MEETING_PARTICIPANTS - : 调用频率限制严格
ZOOM_GET_DAILY_USAGE_REPORT - 、
ZOOM_GET_A_MEETING: 调用频率限制宽松ZOOM_GET_MEETING_RECORDINGS - 、
ZOOM_LIST_MEETINGS: 调用频率限制中等ZOOM_LIST_ALL_RECORDINGS
Parameter Quirks
参数特殊规则
- Nested settings use double underscore notation (e.g., )
settings__waiting_room - expires in 2 hours; renew via API if needed
start_url - is automatically disabled when
join_before_hostiswaiting_roomtrue - Recurring meeting fields () only apply to type
recurrence__*and38 - field has max 10 characters with alphanumeric and
password,@,-,_only*
- 嵌套设置项使用双下划线命名(例如)
settings__waiting_room - 的有效期为2小时;如需延长可通过API重新获取
start_url - 当设置为
waiting_room时,true会自动禁用join_before_host - Recurring会议字段()仅适用于类型
recurrence__*和3的会议8 - 字段最多包含10个字符,仅允许使用字母、数字及
password、@、-、_*
Quick Reference
速查参考
| Task | Tool Slug | Key Params |
|---|---|---|
| Create meeting | | |
| Get meeting details | | |
| Update meeting | | |
| List meetings | | |
| Get user info | | |
| List recordings | | |
| Get recording | | |
| Delete recording | | |
| Past participants | | |
| Daily usage report | | date params |
| Meeting summary | | |
| List webinars | | |
| Get webinar | | webinar ID |
| Register for meeting | | |
| Register for webinar | | webinar ID, participant details |
| List archived files | | |
| 任务 | 工具标识 | 关键参数 |
|---|---|---|
| 创建会议 | | |
| 获取会议详情 | | |
| 更新会议 | | |
| 列出会议 | | |
| 获取用户信息 | | |
| 列出录制内容 | | |
| 获取录制内容 | | |
| 删除录制内容 | | |
| 已结束会议参会者 | | |
| 每日使用报告 | | 日期参数 |
| 会议摘要 | | |
| 列出网络研讨会 | | |
| 获取网络研讨会详情 | | 网络研讨会ID |
| 会议参会者注册 | | |
| 网络研讨会参会者注册 | | 网络研讨会ID, 参会者详情 |
| 列出归档文件 | | |