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.
Toolkit docs: composio.dev/toolkits/zoom
通过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会议的特定场次;如果以开头或包含
/,需进行双重编码// - 场次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格式存储
- 输入本地时间时,请同时提供字段和
timezonestart_time - 使用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会自动禁用join_before_host - Recurring会议字段()仅适用于类型
recurrence__*和38 - 字段最多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 | | |
Powered by Composio
| 任务 | 工具标识 | 关键参数 |
|---|---|---|
| 创建会议 | | |
| 获取会议详情 | | |
| 更新会议 | | |
| 列出会议 | | |
| 获取用户信息 | | |
| 列出录制内容 | | |
| 获取录制内容 | | |
| 删除录制内容 | | |
| 已结束会议参会者 | | |
| 每日使用报告 | | 日期参数 |
| 会议摘要 | | |
| 列出网络研讨会 | | |
| 获取网络研讨会详情 | | 网络研讨会ID |
| 注册会议 | | |
| 注册网络研讨会 | | 网络研讨会ID, 参会者详情 |
| 列出归档文件 | | |
由 Composio 提供支持