Webex Automation

Automate Cisco Webex collaboration workflows -- send messages, manage rooms and teams, configure webhooks, and look up people -- all through natural language.

Toolkit docs: composio.dev/toolkits/webex

Setup

• Add the Rube MCP server to your environment: https://rube.app/mcp

• Connect your Webex account when prompted (OAuth flow via Composio)

• Start issuing natural language commands for Webex automation

Core Workflows

1. Send a Message to a Room or Person

Post plain text, markdown, file attachments, or Adaptive Cards to any Webex room or directly to a person.

Tool: WEBEX_MESSAGING_CREATE_MESSAGE

Key parameters:

• roomId -- target room ID (use WEBEX_MESSAGING_LIST_ROOMS to find it)

• toPersonEmail -- send a private 1:1 message instead (mutually exclusive with roomId )

• text -- plain text content (max 7439 bytes)

• markdown -- markdown-formatted content (takes precedence over text )

• files -- list of public URLs for file attachments (one file per message)

• attachments -- Adaptive Card JSON (one card per message)

• parentId -- reply to a specific message as a threaded response

Example prompt:

"Send a markdown message to room Y2lz... saying Deploy completed with a link to the release notes"

2. List and Discover Rooms

Browse all rooms you belong to, filtered by type, team, or sorted by activity.

Tool: WEBEX_MESSAGING_LIST_ROOMS

Key parameters:

• type -- filter by direct (1:1) or group

• teamId -- limit to rooms in a specific team

• sortBy -- sort by id , lastactivity , or created

• max -- limit results (1-1000, default 100)

Follow-up with WEBEX_MESSAGING_GET_ROOM_DETAILS to get full metadata for a specific room including title, type, lock status, creator, and timestamps.

Example prompt:

"List my 10 most recently active group rooms in Webex"

3. Manage Webhooks for Event-Driven Automation

Create webhooks to receive real-time HTTP POST notifications when Webex resources change.

Tool: WEBEX_WEBHOOKS_CREATE_WEBHOOK

Key parameters:

• name -- human-friendly webhook name (required)

• targetUrl -- URL that receives POST notifications (required)

• resource -- what to monitor: messages , rooms , memberships , meetings , recordings , meetingParticipants , telephony_calls , etc. (required)

• event -- trigger type: created , updated , deleted , started , ended , joined , left (required)

• filter -- scope notifications (e.g., roomId=<id> or hostEmail=<email> )

• secret -- optional HMAC secret for payload signature verification

• ownedBy -- creator for personal or org for organization-wide webhooks

Supporting tools:

• WEBEX_LIST_WEBHOOKS -- list all registered webhooks with optional max and ownedBy filters

• WEBEX_WEBHOOKS_GET_WEBHOOK -- inspect a specific webhook by webhookId

Example prompt:

"Create a webhook called 'New Messages' that POSTs to https://my-app.com/hook whenever a message is created in room Y2lz..."

4. Manage Team Memberships

Add people to Webex teams and optionally grant moderator privileges.

Tool: WEBEX_MESSAGING_CREATE_TEAM_MEMBERSHIP

Key parameters:

• teamId -- the team to add the person to (required)

• personEmail -- email of the person to add

• personId -- Webex person ID (alternative to email)

• isModerator -- set to true for moderator access (default false )

Use WEBEX_LIST_TEAMS to discover available teams first.

Example prompt:

"Add alice@example.com as a moderator to team Y2lz..."

5. Audit Room Memberships

Check who is in a room, verify a specific person's membership, or list memberships across teams.

Tool: WEBEX_MESSAGING_LIST_MEMBERSHIPS

Key parameters:

• roomId -- list all members of a specific room

• personEmail -- check if a person is a member (requires roomId )

• personId -- check by Webex person ID (requires roomId )

• teamId -- filter by team association

• max -- limit results

Example prompt:

"List all members of room Y2lz... and tell me who the moderators are"

6. Search and Look Up People

Look up people in your Webex organization by email, display name, or ID.

Tool: WEBEX_PEOPLE_LIST_PEOPLE

Use to resolve names to person IDs before sending direct messages or adding team members.

Example prompt:

"Find the Webex person ID for bob@company.com"

Known Pitfalls

Pitfall Details

Webhook auto-disable Target URL must respond with HTTP 2xx; 100 failures in 5 minutes disables the webhook automatically

Message size limit Both text and markdown have a 7439-byte maximum

One file per message The files array accepts a list but only one attachment is actually supported per message

One card per message Only one Adaptive Card attachment is supported per message

Mutually exclusive targets roomId and toPersonEmail /toPersonId cannot be used together when sending messages

Room update requires title WEBEX_UPDATE_ROOM always requires the title parameter, even when only changing lock status or team

orgPublicSpaces conflicts Cannot combine orgPublicSpaces with teamId , type , or sortBy when listing rooms

Webhook read scope Creating a webhook requires read scope on the monitored resource type

Membership filter requires roomId personEmail and personId filters in list memberships require roomId unless you are a Compliance Officer

Quick Reference

Action Tool Slug Key Params

Send message WEBEX_MESSAGING_CREATE_MESSAGE

roomId , text /markdown , toPersonEmail

List rooms WEBEX_MESSAGING_LIST_ROOMS

type , sortBy , max

Get room details WEBEX_MESSAGING_GET_ROOM_DETAILS

roomId

Update room WEBEX_UPDATE_ROOM

roomId , title

Delete message WEBEX_MESSAGING_DELETE_MESSAGE

messageId

Get message details WEBEX_MESSAGING_GET_MESSAGE_DETAILS

messageId

Create webhook WEBEX_WEBHOOKS_CREATE_WEBHOOK

name , targetUrl , resource , event

List webhooks WEBEX_LIST_WEBHOOKS

max , ownedBy

Get webhook WEBEX_WEBHOOKS_GET_WEBHOOK

webhookId

Add team member WEBEX_MESSAGING_CREATE_TEAM_MEMBERSHIP

teamId , personEmail , isModerator

List memberships WEBEX_MESSAGING_LIST_MEMBERSHIPS

roomId , personEmail , max

List people WEBEX_PEOPLE_LIST_PEOPLE

email, displayName, ID filters

List teams WEBEX_LIST_TEAMS

max

Powered by Composio