Skip to main content
Glama

Webex MCP Server

Webex MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to Cisco Webex messaging capabilities.

Overview

This MCP server enables AI assistants to interact with Webex messaging through 52 different tools covering:

  • Messages: Send, edit, delete, and retrieve messages
  • Rooms: Create and manage Webex spaces
  • Teams: Team creation and membership management
  • People: User management and directory operations
  • Webhooks: Event notifications and integrations
  • Enterprise Features: ECM folders, room tabs, and attachments

Features

  • Complete Webex API Coverage: 52 tools covering all major messaging operations
  • Docker Support: Production-ready containerization
  • Dual Transport: Both STDIO and SSE (Server-Sent Events) modes
  • Enterprise Ready: Supports Cisco enterprise authentication
  • Type Safe: Full TypeScript/JavaScript implementation with proper error handling
  • Centralized Configuration: Easy token and endpoint management

Quick Start

Prerequisites

  • Node.js 18+ (20+ recommended). Warning: if you run with a lower version of Node, fetch won't be present. Tools use fetch to make HTTP calls. To work around this, you can modify the tools to use node-fetch instead. Make sure that node-fetch is installed as a dependency and then import it as fetch into each tool file.
  • Docker (optional, for containerized deployment)
  • Webex API token from developer.webex.com

Token Renewal

Webex Bearer tokens are short-lived. Your current token expires in 12 hours. To renew:

  1. Visit: https://developer.webex.com/messaging/docs/api/v1/rooms/list-rooms
  2. Login with your email
  3. Copy the new bearer token from your profile
  4. Update environment variable "WEBEX_PUBLIC_WORKSPACE_API_KEY" with new token (remove "Bearer " prefix)

Installation

  1. Clone and install dependencies:
    git clone <repository-url> cd webex-messaging-mcp-server npm install
  2. Configure environment:
    cp .env.example .env # Edit .env with your Webex API token
  3. Test the server:
    # List available tools node index.js tools # Start MCP server node mcpServer.js

Docker Usage

  1. Build and run:
    docker build -t webex-mcp-server . docker run -i --rm --env-file .env webex-mcp-server
  2. Using docker-compose:
    docker-compose up webex-mcp-server

Configuration

Environment Variables

VariableRequiredDescriptionDefault
WEBEX_PUBLIC_WORKSPACE_API_KEYYesWebex API token (without "Bearer " prefix)-
WEBEX_API_BASE_URLNoWebex API base URLhttps://webexapis.com/v1
WEBEX_USER_EMAILNoYour Webex email (for reference)-
PORTNoPort for SSE mode3001

Getting a Webex API Token

  1. Visit developer.webex.com
  2. Sign in with your Cisco/Webex account
  3. Copy the bearer token from the API documentation
  4. Important: Remove the "Bearer " prefix when adding to your .env file

MCP Client Integration

Claude Desktop

Add to your Claude Desktop configuration:

{ "mcpServers": { "webex-messaging": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "WEBEX_PUBLIC_WORKSPACE_API_KEY", "-e", "WEBEX_USER_EMAIL", "-e", "WEBEX_API_BASE_URL", "webex-mcp-server" ], "env": { "WEBEX_USER_EMAIL": "your.email@company.com", "WEBEX_API_BASE_URL": "https://webexapis.com/v1", "WEBEX_PUBLIC_WORKSPACE_API_KEY": "your_token_here" } }, } }

Other MCP Clients

For STDIO mode:

docker run -i --rm --env-file .env webex-mcp-server

For SSE mode:

docker run -p 3001:3001 --rm --env-file .env webex-mcp-server --sse

Available Tools

Core Messaging

  • create_message - Send messages to rooms
  • list_messages - Retrieve message history
  • edit_message - Modify existing messages
  • delete_message - Remove messages
  • get_message_details - Get specific message information

Room Management

  • create_room - Create new Webex spaces
  • list_rooms - Browse available rooms
  • get_room_details - Get room information
  • update_room - Modify room settings
  • delete_room - Remove rooms

Team Operations

  • create_team - Create teams
  • list_teams - Browse teams
  • get_team_details - Get team information
  • update_team - Modify team settings
  • delete_team - Remove teams

Membership Management

  • create_membership - Add people to rooms
  • list_memberships - View room members
  • update_membership - Change member roles
  • delete_membership - Remove members
  • create_team_membership - Add team members
  • list_team_memberships - View team members

People & Directory

  • get_my_own_details - Get your profile
  • list_people - Search for users
  • get_person_details - Get user information
  • create_person - Add new users (admin only)
  • update_person - Modify user details
  • delete_person - Remove users (admin only)

Webhooks & Events

  • create_webhook - Set up event notifications
  • list_webhooks - Manage webhooks
  • get_webhook_details - Get webhook information
  • update_webhook - Modify webhooks
  • delete_webhook - Remove webhooks
  • list_events - Get activity logs
  • get_event_details - Get specific event information

Enterprise Features

  • create_room_tab - Add tabs to rooms
  • list_room_tabs - View room tabs
  • get_room_tab_details - Get tab information
  • update_room_tab - Modify tabs
  • delete_room_tab - Remove tabs
  • create_attachment_action - Handle form submissions
  • get_attachment_action_details - Get attachment details
  • list_ecm_folder - Enterprise content management
  • get_ecm_folder_details - Get ECM folder details
  • create_ecm_folder - Create ECM configurations
  • update_ecm_linked_folder - Modify ECM folders
  • unlink_ecm_linked_folder - Remove ECM links

Development

Project Structure

├── lib/ │ ├── tools.js # Tool discovery and loading │ └── webex-config.js # Centralized API configuration ├── tools/ │ └── webex-public-workspace/webex-messaging/ │ ├── create-a-message.js │ ├── list-messages.js │ └── ... (50 more tools) ├── scripts/ │ └── update-webex-tools.js # Automated tool updates ├── mcpServer.js # Main MCP server ├── index.js # CLI interface ├── Dockerfile # Container configuration └── docker-compose.yml # Multi-container setup

Adding New Tools

  1. Create a new tool file in tools/webex-public-workspace/webex-messaging/
  2. Follow the existing tool pattern with proper imports
  3. Add the tool path to tools/paths.js
  4. Test with node index.js tools

Security

  • Non-root container: Runs as user mcp (UID 1001)
  • Multi-stage build: Optimized production image
  • Environment isolation: Secrets passed via environment variables
  • Health checks: Container monitoring support

Testing

🧪 Comprehensive Test Suite

  • 118 unit tests across 53 test suites
  • 100% pass rate with comprehensive coverage
  • 50+ API endpoints tested end-to-end
  • 20+ critical bug fixes validated
# Run all tests npm test # Run with coverage npm run test:coverage # Validate code quality + tests npm run validate

🔒 Pre-Commit Quality Gates

Automatic quality assurance using Husky pre-commit hooks:

# Automatically runs on git commit: 🚀 Running pre-commit validation... 🔍 Checking code quality and running 118 unit tests... ✅ All validations passed! Commit proceeding...

What's validated:

  • JavaScript syntax checking
  • All 118 unit tests must pass
  • Code quality standards
  • API implementation correctness

See tests/README.md for detailed testing documentation.

Contributing

  1. Fork the repository
  2. Create a feature branch
  3. Make your changes
  4. Tests run automatically on commit via pre-commit hooks
  5. Ensure all 118 tests pass
  6. Submit a pull request

License

MIT License - see LICENSE file for details

Support

  • Issues: Report bugs and feature requests via GitHub issues
  • Documentation: See SETUP-COMPLETE.md for detailed setup instructions
  • Community: Join discussions in the MCP community channels

Related MCP Servers

  • A
    security
    A
    license
    A
    quality
    A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.
    Last updated -
    1
    3,414
    1,774
    TypeScript
    MIT License
    • Apple
  • -
    security
    -
    license
    -
    quality
    A Model Context Protocol (MCP) server that allows AI assistants like Claude to interact with Go's Language Server Protocol (LSP) and benefit from advanced Go code analysis features.
    Last updated -
    Go
    Apache 2.0
  • -
    security
    A
    license
    -
    quality
    A high-performance Model Context Protocol (MCP) server designed for large language models, enabling real-time communication between AI models and applications with support for session management and intelligent tool registration.
    Last updated -
    2
    Python
    MIT License
  • -
    security
    A
    license
    -
    quality
    A modern Model Context Protocol (MCP) server that enables AI assistants to collect interactive user feedback, supporting text and image-based responses.
    Last updated -
    Python
    MIT License

View all related MCP servers

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Kashyap-AI-ML-Solutions/webex-messaging-mcp-server'

If you have feedback or need assistance with the MCP directory API, please join our Discord server