Webex MCP Server

Create a powerful Model Context Protocol (MCP) server for Webex in minutes with our AI Gateway. This guide walks you through setting up seamless Cisco Webex collaboration integration with enterprise-grade security and instant OAuth authentication.

About Webex API

Webex is Cisco's cloud collaboration platform that brings together messaging, video meetings, calling, and file sharing into a single unified experience. The Webex REST API enables developers to build integrations, bots, and applications that interact with Webex messaging, meetings, recordings, transcripts, rooms, people, teams, and webhooks.

Key Capabilities

• Rich Messaging: Send and receive messages with plain text, Markdown formatting, file attachments (up to 100MB), and Adaptive Cards
• Rooms (Spaces) Management: Create and manage group and 1:1 collaboration spaces with moderation controls
• People & User Profiles: Search, list, and view user profiles and presence information within your organization
• Teams & Team Memberships: Organize rooms into teams with shared membership and moderator roles
• Room Memberships: Manage person-to-room relationships with moderator and visibility controls
• Webhooks & Real-Time Events: Subscribe to near-real-time HTTP notifications for messages, memberships, rooms, and more
• Adaptive Cards (Attachment Actions): Build interactive card-based messaging experiences and handle user submissions
• Meeting Scheduling: Schedule, update, and manage single and recurring meetings with join links
• Meeting Invitees & Participants: Manage invitations with co-host designation, track real-time participants, mute/unmute, and admit from lobby
• Meeting Recordings: Access, download, and manage meeting recordings with playback links
• Meeting Transcripts: Retrieve full transcripts and speaker-attributed snippets with timestamps
• Compliance & Audit Events: Retrieve organization-wide events for compliance monitoring and audit trails

API Features

• REST API v1: Comprehensive RESTful interface at https://webexapis.com/v1
• OAuth 2.0 Authentication: Authorization code flow for Webex integrations with granular scopes
• Bearer Token Support: Personal Access Tokens and Bot Tokens for development and automation
• Markdown Messaging: Rich text formatting with full Markdown support
• File Attachments: Upload and share files up to 100MB with anti-malware scanning
• RFC 5988 Pagination: Standard Link header-based pagination for large result sets
• @Mentions: Mention people by email, person ID, or group (e.g., "all")
• HMAC Webhook Signatures: Secret-based payload verification for webhook security

What You Can Do with Webex MCP Server

The MCP server transforms Webex's API into a natural language interface, enabling AI agents to:

Messaging & Communication

• Smart Message Management

  • "Post an update about the deployment to the Project Unicorn space"
  • "Send a direct message to alice@example.com about the meeting agenda"
  • "Share the quarterly report PDF in the leadership room"
  • "List the latest messages in the engineering space"

• Rich Content & Adaptive Cards

  • "Send a Markdown-formatted build status report to the CI/CD room"
  • "Post an approval request card with Approve and Reject buttons"
  • "Get the submitted responses from the feedback card"
  • "Delete the outdated announcement from the general space"

Room & Space Management

• Room Operations

  • "Create a new room called Q3 Planning for the product team"
  • "List all group rooms I belong to, sorted by last activity"
  • "Rename the sprint room to Sprint 15 Kickoff"
  • "Delete the archived project room that's no longer needed"

• Membership Management

  • "Add carol@example.com to the engineering room"
  • "Make Bob a moderator of the project space"
  • "List all members of the Daily Standup room"
  • "Remove the former contractor from all project spaces"

People & User Management

• User Directory

  • "Search for people named Harold in our organization"
  • "Get Alice Johnson's profile and contact details"
  • "Show my own profile information"
  • "List all people matching the email domain @engineering.example.com"

• Profile Administration

  • "Update Bob's display name to Robert Smith"
  • "Look up the person by their Webex person ID"
  • "Check the presence status of team members"

Team Management

• Team Operations

  • "Create a new team called Product Launch 2026"
  • "List all teams I'm a member of"
  • "Rename the Engineering team to Engineering - Platform"
  • "Delete the old hackathon team"

• Team Membership

  • "Add dave@example.com to the Engineering team as a moderator"
  • "List all members of the Marketing team"
  • "Promote Carol to team moderator"
  • "Remove the intern from the team after their rotation ends"

Webhooks & Automation

• Webhook Configuration

  • "Create a webhook to notify our backend when new messages arrive in the project room"
  • "Set up a webhook for all membership changes in the organization"
  • "Create a webhook for Adaptive Card submissions"
  • "List all active webhooks and their target URLs"

• Webhook Management

  • "Update the target URL for the messages webhook to the new server"
  • "Deactivate the old notification webhook"
  • "Delete the webhook that's no longer needed"
  • "Show details for the membership changes webhook"

Meeting Scheduling & Management

• Meeting Operations

  • "Schedule a team standup meeting for every Monday at 9am"
  • "List all my upcoming meetings for this week"
  • "Update the agenda and password for tomorrow's design review"
  • "Get the join link for the all-hands meeting"
  • "Cancel the recurring sprint planning series"

• Meeting Invitees

  • "Add the entire design team as invitees to the review meeting"
  • "Make Sarah a co-host of the quarterly planning meeting"
  • "List all invitees for next week's board meeting"
  • "Remove the external vendor from the internal sync"

Meeting Participants & Control

• Participant Tracking

  • "List all participants who joined the all-hands meeting"
  • "Get details for a specific participant in the training session"
  • "Check who is currently in the lobby waiting to be admitted"

• Participant Management

  • "Admit all participants waiting in the lobby"
  • "Mute the participant causing background noise"
  • "Unmute the presenter for the demo session"

Recordings & Transcripts

• Recording Management

  • "List all recordings from last week's sprint review"
  • "Get the download link for the board meeting recording"
  • "Delete the test recording from the trial meeting"
  • "Show recording details including duration and format"

• Transcript Access

  • "Get the transcript from yesterday's standup meeting"
  • "List all available transcripts for Q1 planning sessions"
  • "Pull speaker-attributed snippets from the architecture review"
  • "Get a specific transcript snippet with timestamps"

Compliance & Audit

• Event Monitoring
  • "List all message creation events from the past week"
  • "Get events performed by a specific user for audit review"
  • "Show all membership change events in the organization"
  • "Retrieve the details of a specific compliance event"

Prerequisites

• Access to Cequence AI Gateway
• Cisco Webex account with appropriate permissions
• One of the following authentication credentials:
  • OAuth 2.0 Integration credentials (client ID and secret) from developer.webex.com
  • Personal Access Token (for development and testing)
  • Bot Token (for automation use cases)

Step 1: Create Webex API Credentials

Before setting up the MCP server, you need API credentials for authentication.

1.1 Option A: Create an OAuth 2.0 Integration

1. Go to developer.webex.com/my-apps
2. Click Create a New App
3. Select Integration
4. Configure your integration:
   • Integration Name: "AI Gateway Integration"
   • Description: "Cequence AI Gateway MCP Server for Webex"
   • Redirect URI:

     https://auth.aigateway.cequence.ai/v1/outbound/oauth/callback

   • Scopes: Select the scopes matching your use case:
     • spark:messages_read / spark:messages_write for messaging
     • spark:rooms_read / spark:rooms_write for room management
     • spark:people_read for user directory access
     • spark:memberships_read / spark:memberships_write for membership management
     • spark:teams_read / spark:teams_write for team management
     • spark:team_memberships_read / spark:team_memberships_write for team membership management
     • spark:webhooks_read / spark:webhooks_write for webhook management
     • meeting:schedules_read / meeting:schedules_write for meetings
     • meeting:recordings_read / meeting:recordings_write for recordings
     • meeting:participants_read / meeting:participants_write for participants
     • meeting:transcripts_read / meeting:transcripts_write for transcripts
5. Click Add Integration
6. Copy the Client ID and Client Secret (the secret is shown only once)

1.2 Option B: Personal Access Token (Development)

1. Go to developer.webex.com
2. Log in and navigate to your profile
3. Copy your Personal Access Token from the developer portal
4. Note: Personal Access Tokens expire after 12 hours and are intended for development use only

1.3 Option C: Bot Token (Automation)

1. Go to developer.webex.com/my-apps
2. Click Create a New App
3. Select Bot
4. Configure the bot name, username, and description
5. Copy the Bot Access Token (shown only once)

Step 2: Access AI Gateway Apps

1. Log in to your Cequence AI Gateway dashboard
2. Navigate to Apps in the left sidebar
3. You'll see the list of available third-party applications

Step 3: Find and Select Webex API

1. In the Apps section, browse through the Third-party category
2. Look for Webex or use the search function
3. Click on the Webex API card to view details

The Webex API card shows:

• Number of available endpoints
• Integration capabilities
• Quick description of functionality

Step 4: Create MCP Server

1. Click the Create MCP Server button on the Webex API card
2. You'll be redirected to the MCP Server creation wizard

Step 5: Configure API Endpoints

In the App Configuration step:

1. Base URL: https://webexapis.com/v1 (pre-configured)
2. Select API endpoints to expose to your MCP server based on your needs:
   • Messages endpoints for messaging operations
   • Rooms endpoints for space management
   • People endpoints for user directory
   • Teams and Team Memberships endpoints for team management
   • Memberships endpoints for room member management
   • Webhooks endpoints for event subscriptions
   • Attachment Actions endpoints for Adaptive Card handling
   • Events endpoints for compliance and audit
   • Meetings endpoints for scheduling and management
   • Meeting Invitees endpoints for invitation management
   • Meeting Participants endpoints for attendee tracking and control
   • Recordings endpoints for meeting recording access
   • Meeting Transcripts endpoints for transcript retrieval
3. Click Next to proceed

Step 6: MCP Server Basic Setup

Configure your MCP server details:

1. MCP Server Name: Enter a descriptive name

   • Example: "Webex Team Collaboration"
   • This name will identify your server in the dashboard

2. Description (Optional): Add details about the server's purpose

   • Example: "Webex messaging, rooms, and team management for AI-powered collaboration"

3. Production Mode: Toggle based on your needs

   • ON for production environments
   • OFF for development/testing

4. Click Next to continue

Step 7: Configure Authentication

Option A: OAuth 2.0 Authentication (Recommended)

1. Authentication Type: Select OAuth 2.0
2. Fill in the OAuth configuration:
   • Authorization URL: https://webexapis.com/v1/authorize
   • Token URL: https://webexapis.com/v1/access_token
   • Client ID: Paste from your Webex integration
   • Client Secret: Paste from your Webex integration
   • Redirect URI:

     https://auth.aigateway.cequence.ai/v1/outbound/oauth/callback

3. Scopes: Configure based on your selected endpoints:
   • spark:messages_read spark:messages_write
   • spark:rooms_read spark:rooms_write
   • spark:people_read
   • spark:memberships_read spark:memberships_write
   • spark:teams_read spark:teams_write
   • spark:team_memberships_read spark:team_memberships_write
   • spark:webhooks_read spark:webhooks_write
   • meeting:schedules_read meeting:schedules_write
   • meeting:recordings_read meeting:recordings_write
   • meeting:participants_read meeting:participants_write
   • meeting:transcripts_read meeting:transcripts_write

Option B: Bearer Token Authentication

1. Authentication Type: Select Bearer Token
2. Token: Paste your Personal Access Token or Bot Token
3. Header: Authorization: Bearer YOUR_TOKEN
4. Test connection to verify access

Step 8: Configure Security

Set up API protection features:

1. API Protection: Toggle ON to enable

   • Protects against bot attacks, DDoS, and threats
   • Monitors for suspicious activity
   • Rate limiting and anomaly detection

2. Protection Features (when enabled):

   • Auto-scaling protection
   • Managed infrastructure
   • Built-in monitoring
   • Zero maintenance required

3. Click Next to continue

Step 9: Choose Deployment Method

Select your deployment preference:

Option A: Deploy to Cequence Cloud (Recommended)

• Fully managed deployment
• Automatic scaling and monitoring
• Built-in high availability
• Features included:
  • Auto-scaling
  • Managed infrastructure
  • Built-in monitoring
  • Zero maintenance

Option B: Deploy with Helm Chart

• Self-managed Kubernetes deployment
• Full control over infrastructure
• Requires:
  • Kubernetes cluster
  • Helm 3.x installed
  • Container registry access

Click Next after selecting your deployment method.

Step 10: Review and Deploy

Review your MCP server configuration:

• MCP Server Name: Your chosen name
• Base URL: https://webexapis.com/v1
• Selected Endpoints: Number of endpoints selected
• Authentication: OAuth 2.0 or Bearer Token (Configured)
• API Protection: Enabled/Disabled
• Deployment: Cequence Cloud or Helm

Click Create & Deploy to finalize the setup.

Step 11: Post-Deployment Setup

After successful deployment:

1. Note the MCP Server URL provided

2. Test the connection:

   • Click Test Connection
   • Verify successful authentication
   • Confirm access to your Webex account

3. Configure AI Agents:

   • The MCP server is now available for AI agent connections
   • Use the provided server URL in your AI agent configuration

Available Webex API Operations

Messages APIs

• Message Management
  • List messages in a room (with filters for mentions, date range, pagination)
  • Create messages with plain text, Markdown, file attachments, or Adaptive Cards
  • Get message details by message ID
  • Delete messages (own messages or with compliance scope)

Rooms APIs

• Room (Space) Management
  • List rooms with filters by team, type (direct/group), and sort order
  • Create rooms (standalone or within a team)
  • Get room details by room ID
  • Update room title
  • Delete rooms and all associated content

People APIs

• User Directory
  • List and search people by email, display name, ID, or organization
  • Get person details by person ID
  • Get authenticated user's own profile
  • Update person details (admin only)

Teams APIs

• Team Management
  • List teams the user belongs to
  • Create teams (auto-creates General room)
  • Get team details by team ID
  • Update team name
  • Delete teams and all associated rooms

Team Memberships APIs

• Team Member Management
  • List team memberships for a given team
  • Add members to a team by person ID or email
  • Get team membership details
  • Update moderator status
  • Remove members from a team

Memberships APIs

• Room Member Management
  • List room memberships with filters by room, person, or email
  • Add members to a room by person ID or email
  • Get membership details
  • Update moderator status and room visibility
  • Remove members from a room

Webhooks APIs

• Webhook Management
  • List all webhooks
  • Create webhooks for resources (messages, memberships, rooms, meetings, attachmentActions) and events (created, updated, deleted, all)
  • Get webhook details by webhook ID
  • Update webhook name, target URL, secret, and status
  • Delete webhooks

Attachment Actions APIs

• Adaptive Card Interactions
  • Create attachment actions (submit Adaptive Card inputs)
  • Get attachment action details and submitted input values

Events APIs

• Compliance & Audit
  • List events with filters by resource type, event type, actor, and date range
  • Get event details by event ID

Meetings APIs

• Meeting Management
  • List meetings with filters by meeting type, state, and date range
  • Create meetings (single or recurring series) with agenda, password, and scheduling options
  • Get meeting details by meeting ID
  • Update meeting title, agenda, schedule, and password
  • Delete meetings or cancel recurring series
  • Get join link for a meeting

Meeting Invitees APIs

• Invitee Management
  • List invitees for a meeting
  • Add invitees by email with optional co-host designation
  • Get invitee details by invitee ID
  • Update invitee settings (co-host status)
  • Remove invitees from a meeting

Meeting Participants APIs

• Participant Tracking & Control
  • List participants for a meeting (in-progress or completed)
  • Get participant details by participant ID
  • Update participant status (mute/unmute audio and video)
  • Admit participants from the meeting lobby

Recordings APIs

• Recording Access
  • List recordings with filters by meeting ID, date range, and status
  • Get recording details including download link, duration, format, and size
  • Delete recordings

Meeting Transcripts APIs

• Transcript Retrieval
  • List transcripts with filters by meeting ID and date range
  • Get transcript details by transcript ID
  • List transcript snippets with speaker attribution and timestamps
  • Get individual snippet details by snippet ID

Using Your Webex MCP Server

Setup Instructions:

• Claude Desktop
• Claude Code
• Cursor
• VS Code
• Windsurf

Common Use Cases

Team Communication Automation

• Automated project status updates posted to relevant rooms
• Cross-team broadcast messaging for announcements
• Scheduled reminders and notifications via bot integrations
• AI-assisted message drafting and response suggestions

Room & Space Management

• Automated room creation for new projects or teams
• Membership synchronization with external directory systems
• Room archival and cleanup for completed projects
• Moderator assignment and access control enforcement

User Directory & Profiles

• Employee lookup and contact information retrieval
• Organization-wide people search for collaboration discovery
• User profile synchronization with HR systems
• Presence status monitoring for availability-aware workflows

Meeting Management & Scheduling

• Automated meeting creation for recurring standups and planning sessions
• Invitee synchronization with external calendar and directory systems
• Post-meeting distribution of recordings and transcripts to relevant rooms
• Participant tracking and attendance reporting
• Meeting lifecycle management (schedule, update, cancel) via AI agents

Webhook-Driven Workflows

• Real-time message-triggered automation pipelines
• Membership change notifications for access management
• Adaptive Card-based approval workflows with form submissions
• Event-driven integrations with external systems (CI/CD, ticketing, CRM)

Compliance & Audit

• Organization-wide message event monitoring
• User activity tracking and audit trail generation
• Data retention policy enforcement via event monitoring
• Compliance reporting for regulatory requirements

Best Practices

1. OAuth Scope Minimization:

   • Request only the scopes your integration actually needs
   • Use read-only scopes when write access is not required
   • Avoid spark:all unless full access is genuinely necessary

2. Token Management:

   • Use OAuth 2.0 integrations for production (not Personal Access Tokens)
   • Use Bot Tokens for automation that doesn't require user context
   • Store tokens securely and rotate them according to your security policy

3. Webhook Security:

   • Always set a secret when creating webhooks for HMAC signature verification
   • Validate webhook payload signatures on your receiving endpoint
   • Use HTTPS target URLs for all webhook endpoints
   • Filter webhooks by room or resource to reduce noise

4. Rate Limiting & Pagination:

   • Respect Webex API rate limits (check Retry-After headers on 429 responses)
   • Use the max query parameter and RFC 5988 Link headers for paginated results
   • Implement exponential backoff for retries

Troubleshooting

Common Issues

1. Authentication Errors

   • Verify the OAuth client ID and secret are correct
   • Check that the redirect URI matches exactly (including trailing slash)
   • Ensure the Personal Access Token has not expired (12-hour lifetime)
   • Confirm the Bot Token is still valid and the bot is active

2. Scope & Permission Errors

   • Verify the integration has the required scopes for the endpoints you are calling
   • Admin-only operations (e.g., updating people) require admin-level tokens
   • Compliance endpoints require spark:all or spark-compliance:* scopes

3. Webhook Delivery Failures

   • Ensure the target URL is publicly reachable and responds with 2xx status
   • Check that the webhook status is "active" (not "inactive")
   • Verify TLS certificates on the target endpoint are valid
   • Review webhook secret configuration if signature validation fails

4. Connection Issues

   • Confirm the base URL is https://webexapis.com/v1
   • Verify network connectivity from AI Gateway to the Webex API
   • Check firewall rules allow outbound HTTPS traffic to webexapis.com
   • Review tracking IDs in error responses for Webex support

Getting Help

• Documentation: AI Gateway Docs
• Support: support@cequence.ai
• Community: AI Gateway Forum
• Webex Developer Portal: developer.webex.com
• Webex Messaging API: Messaging API Basics
• Webex Meetings API: Meetings API Overview

---