KosmoKrator

communication

Zoom CLI for AI Agents

Use the Zoom CLI from KosmoKrator to call Zoom tools headlessly, return JSON, inspect schemas, and automate workflows from coding agents, scripts, and CI.

7 functions 6 read 1 write Manual OAuth token auth

Zoom CLI Setup

Zoom can be configured headlessly with `kosmokrator integrations:configure zoom`.

# Install KosmoKrator first if it is not available on PATH.
curl -fsSL https://raw.githubusercontent.com/OpenCompanyApp/kosmokrator/main/install.sh | bash

# Configure and verify this integration.
kosmokrator integrations:configure zoom --set access_token="$ZOOM_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor zoom --json
kosmokrator integrations:status --json

Credentials

Authentication type: Manual OAuth token oauth2_manual_token. Configure credentials once, then use the same stored profile from scripts, coding CLIs, Lua code mode, and the MCP gateway.

KeyEnv varTypeRequiredLabel
access_token ZOOM_ACCESS_TOKEN Secret secret yes Access Token
url ZOOM_URL URL url no API Base URL

Call Zoom Headlessly

Use the generic call form when another coding CLI or script needs a stable universal interface.

kosmo integrations:call zoom.zoom_create_meeting '{
  "topic": "example_topic",
  "type": "example_type",
  "start_time": "example_start_time",
  "duration": 1,
  "timezone": "example_timezone",
  "agenda": "example_agenda",
  "user_id": "example_user_id",
  "settings": "example_settings"
}' --json

Use the provider shortcut form for shorter human-facing commands.

kosmo integrations:zoom zoom_create_meeting '{
  "topic": "example_topic",
  "type": "example_type",
  "start_time": "example_start_time",
  "duration": 1,
  "timezone": "example_timezone",
  "agenda": "example_agenda",
  "user_id": "example_user_id",
  "settings": "example_settings"
}' --json

Agent Discovery Commands

These commands return structured output for coding agents that need to inspect capabilities before choosing a function.

kosmo integrations:docs zoom --json
kosmo integrations:docs zoom.zoom_create_meeting --json
kosmo integrations:schema zoom.zoom_create_meeting --json
kosmo integrations:search "Zoom" --json
kosmo integrations:list --json

All CLI Functions

Every function below can be called headlessly. The generic form is stable across all integrations; the provider shortcut is shorter but specific to Zoom.

zoom.zoom_create_meeting

Write write

Create a new Zoom meeting. Provide a topic, start time (ISO 8601), duration, and optional timezone. Returns the meeting with join URL and password.

Parameters
topic, type, start_time, duration, timezone, agenda, user_id, settings

Generic CLI call

kosmo integrations:call zoom.zoom_create_meeting '{"topic":"example_topic","type":"example_type","start_time":"example_start_time","duration":1,"timezone":"example_timezone","agenda":"example_agenda","user_id":"example_user_id","settings":"example_settings"}' --json

Provider shortcut

kosmo integrations:zoom zoom_create_meeting '{"topic":"example_topic","type":"example_type","start_time":"example_start_time","duration":1,"timezone":"example_timezone","agenda":"example_agenda","user_id":"example_user_id","settings":"example_settings"}' --json

zoom.zoom_get_current_user

Read read

Get the profile of the currently authenticated Zoom user. Returns email, name, account type, status, and timezone.

Parameters
none

Generic CLI call

kosmo integrations:call zoom.zoom_get_current_user '{}' --json

Provider shortcut

kosmo integrations:zoom zoom_get_current_user '{}' --json

zoom.zoom_get_meeting

Read read

Get details of a specific Zoom meeting by ID. Returns the meeting topic, agenda, start time, duration, join URL, and settings.

Parameters
meeting_id

Generic CLI call

kosmo integrations:call zoom.zoom_get_meeting '{"meeting_id":"example_meeting_id"}' --json

Provider shortcut

kosmo integrations:zoom zoom_get_meeting '{"meeting_id":"example_meeting_id"}' --json

zoom.zoom_get_user

Read read

Get details of a specific Zoom user by ID or "me" for the authenticated user. Returns email, name, type, status, and timezone.

Parameters
user_id

Generic CLI call

kosmo integrations:call zoom.zoom_get_user '{"user_id":"example_user_id"}' --json

Provider shortcut

kosmo integrations:zoom zoom_get_user '{"user_id":"example_user_id"}' --json

zoom.zoom_list_meetings

Read read

List meetings for a Zoom user. Returns meeting IDs, topics, start times, durations, and join URLs. Use type "live" for in-progress, "scheduled" for upcoming, or "upcoming" for all upcoming meetings.

Parameters
user_id, type, page_size, next_page_token

Generic CLI call

kosmo integrations:call zoom.zoom_list_meetings '{"user_id":"example_user_id","type":"example_type","page_size":1,"next_page_token":"example_next_page_token"}' --json

Provider shortcut

kosmo integrations:zoom zoom_list_meetings '{"user_id":"example_user_id","type":"example_type","page_size":1,"next_page_token":"example_next_page_token"}' --json

zoom.zoom_list_recordings

Read read

List cloud recordings for a Zoom user. Returns recording IDs, topics, start times, durations, and download URLs for recording files.

Parameters
user_id, page_size, next_page_token

Generic CLI call

kosmo integrations:call zoom.zoom_list_recordings '{"user_id":"example_user_id","page_size":1,"next_page_token":"example_next_page_token"}' --json

Provider shortcut

kosmo integrations:zoom zoom_list_recordings '{"user_id":"example_user_id","page_size":1,"next_page_token":"example_next_page_token"}' --json

zoom.zoom_list_users

Read read

List users in the Zoom account. Returns user IDs, emails, names, types (1=basic, 2=licensed), and status. Use this to find user IDs for other operations.

Parameters
page_size, next_page_token

Generic CLI call

kosmo integrations:call zoom.zoom_list_users '{"page_size":1,"next_page_token":"example_next_page_token"}' --json

Provider shortcut

kosmo integrations:zoom zoom_list_users '{"page_size":1,"next_page_token":"example_next_page_token"}' --json

Function Schemas

Use these parameter tables when building CLI payloads without calling integrations:schema first.

zoom.zoom_create_meeting

Create a new Zoom meeting. Provide a topic, start time (ISO 8601), duration, and optional timezone. Returns the meeting with join URL and password.

Operation
Write write
Schema command
kosmo integrations:schema zoom.zoom_create_meeting --json
ParameterTypeRequiredDescription
topic string yes Meeting topic/title.
type string no Meeting type: "1" = instant, "2" = scheduled (default), "3" = recurring no fixed time, "8" = recurring fixed time.
start_time string no Meeting start time in ISO 8601 format (e.g. "2024-01-15T10:00:00Z"). Required for scheduled meetings.
duration integer no Meeting duration in minutes. Default: 30.
timezone string no Timezone for the meeting (e.g. "America/New_York").
agenda string no Meeting description/agenda.
user_id string no User ID to create the meeting for. Default: "me".
settings object no Meeting settings (join_before_host, mute_upon_entry, etc.).

zoom.zoom_get_current_user

Get the profile of the currently authenticated Zoom user. Returns email, name, account type, status, and timezone.

Operation
Read read
Schema command
kosmo integrations:schema zoom.zoom_get_current_user --json
ParameterTypeRequiredDescription
No parameters.

zoom.zoom_get_meeting

Get details of a specific Zoom meeting by ID. Returns the meeting topic, agenda, start time, duration, join URL, and settings.

Operation
Read read
Schema command
kosmo integrations:schema zoom.zoom_get_meeting --json
ParameterTypeRequiredDescription
meeting_id string yes The meeting ID or UUID.

zoom.zoom_get_user

Get details of a specific Zoom user by ID or "me" for the authenticated user. Returns email, name, type, status, and timezone.

Operation
Read read
Schema command
kosmo integrations:schema zoom.zoom_get_user --json
ParameterTypeRequiredDescription
user_id string yes The user ID or "me" for the authenticated user.

zoom.zoom_list_meetings

List meetings for a Zoom user. Returns meeting IDs, topics, start times, durations, and join URLs. Use type "live" for in-progress, "scheduled" for upcoming, or "upcoming" for all upcoming meetings.

Operation
Read read
Schema command
kosmo integrations:schema zoom.zoom_list_meetings --json
ParameterTypeRequiredDescription
user_id string no User ID or "me" for the authenticated user. Default: "me".
type string no Meeting type filter: scheduled, live, or upcoming. Default: "live".
page_size integer no Number of meetings per page (1–300). Default: 30.
next_page_token string no Token for the next page of results.

zoom.zoom_list_recordings

List cloud recordings for a Zoom user. Returns recording IDs, topics, start times, durations, and download URLs for recording files.

Operation
Read read
Schema command
kosmo integrations:schema zoom.zoom_list_recordings --json
ParameterTypeRequiredDescription
user_id string no User ID or "me" for the authenticated user. Default: "me".
page_size integer no Number of recordings per page (1–300). Default: 30.
next_page_token string no Token for the next page of results.

zoom.zoom_list_users

List users in the Zoom account. Returns user IDs, emails, names, types (1=basic, 2=licensed), and status. Use this to find user IDs for other operations.

Operation
Read read
Schema command
kosmo integrations:schema zoom.zoom_list_users --json
ParameterTypeRequiredDescription
page_size integer no Number of users per page (1–300). Default: 30.
next_page_token string no Token for the next page of results.

Permissions

Headless calls still follow the integration read/write permission policy. Configure read/write defaults with integrations:configure. Add --force only for trusted automation that should bypass that policy.