Zoom

Schedule, list, and manage Zoom meetings and recordings with ZoomTools using Server-to-Server OAuth credentials.

Zoom enables an Agent to interact with Zoom, allowing it to schedule meetings, manage recordings, and handle various meeting-related operations through the Zoom API. The toolkit uses Zoom’s Server-to-Server OAuth authentication for secure API access.

Prerequisites

The Zoom toolkit requires the following setup:

1. Install required dependencies:

uv pip install requests openai

2. Set up Server-to-Server OAuth app in Zoom Marketplace:

   • Go to Zoom Marketplace
   • Click “Develop” → “Build App”
   • Choose “Server-to-Server OAuth” app type
   • Configure the app with required scopes:
     • meeting:write:admin
     • meeting:read:admin
     • cloud_recording:read:admin
   • Note your Account ID, Client ID, and Client Secret

3. Set up environment variables:

export ZOOM_ACCOUNT_ID=your_account_id
export ZOOM_CLIENT_ID=your_client_id
export ZOOM_CLIENT_SECRET=your_client_secret

Example Usage

from agno.agent import Agent
from agno.tools.zoom import ZoomTools

# Initialize Zoom tools with credentials
zoom_tools = ZoomTools(
    account_id="your_account_id",
    client_id="your_client_id",
    client_secret="your_client_secret"
)

# Create an agent with Zoom capabilities
agent = Agent(tools=[zoom_tools])

# Schedule a meeting
agent.print_response("""
Schedule a team meeting with the following details:
- Topic: Weekly Team Sync
- Time: Tomorrow at 2 PM UTC
- Duration: 45 minutes
""", markdown=True)

Toolkit Params

Parameter	Type	Default	Description
account_id	Optional[str]	None	Zoom account ID. If not provided, uses ZOOM_ACCOUNT_ID environment variable.
client_id	Optional[str]	None	Zoom client ID. If not provided, uses ZOOM_CLIENT_ID environment variable.
client_secret	Optional[str]	None	Zoom client secret. If not provided, uses ZOOM_CLIENT_SECRET environment variable.
timeout	int	30	Per-request HTTP timeout in seconds.

Toolkit Functions

Function	Description
get_access_token	Get or refresh the Server-to-Server OAuth access token
schedule_meeting	Schedule a new Zoom meeting
get_upcoming_meetings	Get a list of upcoming meetings
list_meetings	List all meetings based on type
get_meeting_recordings	Get recordings for a specific meeting
delete_meeting	Delete a scheduled meeting
get_meeting	Get detailed information about a specific meeting

You can use include_tools or exclude_tools to modify the list of tools the agent has access to. Learn more about selecting tools.

Rate Limits

The Zoom API groups endpoints into Light, Medium, Heavy, and Resource-intensive categories, each with its own requests-per-second limit that scales with your account plan. Each endpoint’s documentation lists which category it falls under.

For exact per-plan values, refer to Zoom API Rate Limits.

Developer Resources

• Tools