KosmoKrator

communication

Cisco Webex CLI for AI Agents

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

6 functions 5 read 1 write Manual OAuth token auth

Cisco Webex CLI Setup

Cisco Webex can be configured headlessly with `kosmokrator integrations:configure webex`.

# 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 webex --set access_token="$WEBEX_ACCESS_TOKEN" --enable --read allow --write ask --json
kosmokrator integrations:doctor webex --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 WEBEX_ACCESS_TOKEN Secret secret yes Access Token
url WEBEX_URL URL url no API Base URL

Call Cisco Webex Headlessly

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

kosmo integrations:call webex.webex_list_rooms '{
  "max": 1,
  "before": "example_before",
  "after": "example_after"
}' --json

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

kosmo integrations:webex webex_list_rooms '{
  "max": 1,
  "before": "example_before",
  "after": "example_after"
}' --json

Agent Discovery Commands

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

kosmo integrations:docs webex --json
kosmo integrations:docs webex.webex_list_rooms --json
kosmo integrations:schema webex.webex_list_rooms --json
kosmo integrations:search "Cisco Webex" --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 Cisco Webex.

webex.webex_list_rooms

Read read

List Webex spaces (rooms) the authenticated user belongs to. Returns room IDs, titles, types, and last activity timestamps. Use for discovering available rooms before reading messages or posting.

Parameters
max, before, after

Generic CLI call

kosmo integrations:call webex.webex_list_rooms '{"max":1,"before":"example_before","after":"example_after"}' --json

Provider shortcut

kosmo integrations:webex webex_list_rooms '{"max":1,"before":"example_before","after":"example_after"}' --json

webex.webex_get_room

Read read

Get details for a specific Webex room by its ID. Returns room title, type (direct or group), creator, creation date, and last activity.

Parameters
room_id

Generic CLI call

kosmo integrations:call webex.webex_get_room '{"room_id":"example_room_id"}' --json

Provider shortcut

kosmo integrations:webex webex_get_room '{"room_id":"example_room_id"}' --json

webex.webex_list_messages

Read read

List messages in a Webex room. Supports date-based filtering with before/after parameters and pagination. Returns message text, sender info, and timestamps.

Parameters
room_id, max, before, after

Generic CLI call

kosmo integrations:call webex.webex_list_messages '{"room_id":"example_room_id","max":1,"before":"example_before","after":"example_after"}' --json

Provider shortcut

kosmo integrations:webex webex_list_messages '{"room_id":"example_room_id","max":1,"before":"example_before","after":"example_after"}' --json

webex.webex_create_message

Write write

Post a new message to a Webex room. Supports plain text and Markdown formatting. Provide either "text" (plain text) or "markdown" (formatted), or both — Webex will display Markdown to clients that support it and fall back to plain text.

Parameters
room_id, text, markdown

Generic CLI call

kosmo integrations:call webex.webex_create_message '{"room_id":"example_room_id","text":"example_text","markdown":"example_markdown"}' --json

Provider shortcut

kosmo integrations:webex webex_create_message '{"room_id":"example_room_id","text":"example_text","markdown":"example_markdown"}' --json

webex.webex_list_meetings

Read read

List scheduled Webex meetings for the authenticated user. Supports date range filtering with "from" and "to" parameters (ISO 8601). Returns meeting titles, start/end times, and join links.

Parameters
from, to, max

Generic CLI call

kosmo integrations:call webex.webex_list_meetings '{"from":"example_from","to":"example_to","max":1}' --json

Provider shortcut

kosmo integrations:webex webex_list_meetings '{"from":"example_from","to":"example_to","max":1}' --json

webex.webex_get_current_user

Read read

Get the profile of the currently authenticated Webex user. Returns display name, email, avatar, and account details. Useful for identifying which account the integration is connected to.

Parameters
none

Generic CLI call

kosmo integrations:call webex.webex_get_current_user '{}' --json

Provider shortcut

kosmo integrations:webex webex_get_current_user '{}' --json

Function Schemas

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

webex.webex_list_rooms

List Webex spaces (rooms) the authenticated user belongs to. Returns room IDs, titles, types, and last activity timestamps. Use for discovering available rooms before reading messages or posting.

Operation
Read read
Schema command
kosmo integrations:schema webex.webex_list_rooms --json
ParameterTypeRequiredDescription
max integer no Maximum number of rooms to return (1–1000, default: 100).
before string no List rooms before this ISO 8601 timestamp (for pagination).
after string no List rooms after this ISO 8601 timestamp (for pagination).

webex.webex_get_room

Get details for a specific Webex room by its ID. Returns room title, type (direct or group), creator, creation date, and last activity.

Operation
Read read
Schema command
kosmo integrations:schema webex.webex_get_room --json
ParameterTypeRequiredDescription
room_id string yes The unique identifier of the Webex room.

webex.webex_list_messages

List messages in a Webex room. Supports date-based filtering with before/after parameters and pagination. Returns message text, sender info, and timestamps.

Operation
Read read
Schema command
kosmo integrations:schema webex.webex_list_messages --json
ParameterTypeRequiredDescription
room_id string yes The room to list messages from.
max integer no Maximum number of messages to return (1–1000, default: 50).
before string no List messages posted before this ISO 8601 timestamp.
after string no List messages posted after this ISO 8601 timestamp.

webex.webex_create_message

Post a new message to a Webex room. Supports plain text and Markdown formatting. Provide either "text" (plain text) or "markdown" (formatted), or both — Webex will display Markdown to clients that support it and fall back to plain text.

Operation
Write write
Schema command
kosmo integrations:schema webex.webex_create_message --json
ParameterTypeRequiredDescription
room_id string yes The room to post the message in.
text string no Plain-text content of the message.
markdown string no Markdown-formatted content of the message.

webex.webex_list_meetings

List scheduled Webex meetings for the authenticated user. Supports date range filtering with "from" and "to" parameters (ISO 8601). Returns meeting titles, start/end times, and join links.

Operation
Read read
Schema command
kosmo integrations:schema webex.webex_list_meetings --json
ParameterTypeRequiredDescription
from string no Start of the date range (ISO 8601, e.g., "2025-04-01T00:00:00Z"). Lists meetings starting from this time.
to string no End of the date range (ISO 8601, e.g., "2025-04-30T23:59:59Z"). Lists meetings up to this time.
max integer no Maximum number of meetings to return (1–100, default: 100).

webex.webex_get_current_user

Get the profile of the currently authenticated Webex user. Returns display name, email, avatar, and account details. Useful for identifying which account the integration is connected to.

Operation
Read read
Schema command
kosmo integrations:schema webex.webex_get_current_user --json
ParameterTypeRequiredDescription
No parameters.

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.