WebexTools enable an Agent to interact with Cisco Webex, allowing it to send messages and list rooms.

​
Prerequisites

The following example requires the webexpythonsdk library and a Webex access token which can be obtained from Webex Developer Portal.

To get started with Webex:

  1. Create a Webex Bot:

    • Go to the Developer Portal
    • Navigate to My Webex Apps → Create a Bot
    • Fill in the bot details and click Add Bot

  2. Get your access token:

    • Copy the token shown after bot creation
    • Or regenerate via My Webex Apps → Edit Bot
    • Set as WEBEX_ACCESS_TOKEN environment variable

  3. Add the bot to Webex:

    • Launch Webex and add the bot to a space
    • Use the bot’s email (e.g. test@webex.bot)
pip install webexpythonsdk

export WEBEX_ACCESS_TOKEN=your_access_token_here

​
Example

The following agent will list all spaces and send a message using Webex:

cookbook/tools/webex_tool.py
from agno.agent import Agent
from agno.tools.webex import WebexTools

agent = Agent(tools=[WebexTools()], show_tool_calls=True)

# List all spaces in Webex
agent.print_response("List all space on our Webex", markdown=True)

# Send a message to a Space in Webex
agent.print_response(
    "Send a funny ice-breaking message to the webex Welcome space", markdown=True
)

​
Toolkit Params

ParameterTypeDefaultDescription
access_tokenstrNoneWebex access token for authentication. If not provided, uses WEBEX_ACCESS_TOKEN environment variable.
send_messageboolTrueEnable sending messages to Webex spaces.
list_roomsboolTrueEnable listing Webex spaces/rooms.

​
Toolkit Functions

FunctionDescription
send_messageSends a message to a Webex room. Parameters: room_id (str) for the target room, text (str) for the message.
list_roomsLists all available Webex rooms/spaces with their details including ID, title, type, and visibility settings.

​
Developer Resources