The Webex MCP Server enables AI assistants to comprehensively interact with Cisco Webex messaging and collaboration features through 52 different tools across various domains:
- Message Management: Send, edit, delete, and retrieve messages in Webex rooms
- Room/Space Management: Create, manage, and delete Webex rooms/spaces
- Team Operations: Create, list, update, and delete Webex teams
- Membership Management: Add, remove, and update members in rooms and teams
- People and Directory Operations: Manage user profiles and access directory information
- Webhook and Event Management: Set up and manage webhooks for event notifications
- Enterprise Features: Handle ECM folders, room tabs, attachments, and meeting details
This server supports integration with AI assistants via MCP client in both STDIO and SSE modes.
Enables AI assistants to interact with Cisco enterprise authentication and Webex messaging ecosystem, supporting enterprise content management, team collaboration, and messaging operations.
Provides comprehensive access to Cisco Webex messaging capabilities through 52 different tools covering messages, rooms, teams, people management, webhooks, and enterprise features like ECM folders and room tabs.
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 usefetch
to make HTTP calls. To work around this, you can modify the tools to usenode-fetch
instead. Make sure thatnode-fetch
is installed as a dependency and then import it asfetch
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:
- Visit: https://developer.webex.com/messaging/docs/api/v1/rooms/list-rooms
- Login with your email
- Copy the new bearer token from your profile
- Update environment variable "WEBEX_PUBLIC_WORKSPACE_API_KEY" with new token (remove "Bearer " prefix)
Installation
- Clone and install dependencies:
- Configure environment:
- Test the server:
Docker Usage
- Build and run:
- Using docker-compose:
Configuration
Environment Variables
Variable | Required | Description | Default |
---|---|---|---|
WEBEX_PUBLIC_WORKSPACE_API_KEY | Yes | Webex API token (without "Bearer " prefix) | - |
WEBEX_API_BASE_URL | No | Webex API base URL | https://webexapis.com/v1 |
WEBEX_USER_EMAIL | No | Your Webex email (for reference) | - |
PORT | No | Port for SSE mode | 3001 |
Getting a Webex API Token
- Visit developer.webex.com
- Sign in with your Cisco/Webex account
- Copy the bearer token from the API documentation
- Important: Remove the "Bearer " prefix when adding to your
.env
file
MCP Client Integration
Claude Desktop
Add to your Claude Desktop configuration:
Other MCP Clients
For STDIO mode:
For SSE mode:
Available Tools
Core Messaging
create_message
- Send messages to roomslist_messages
- Retrieve message historyedit_message
- Modify existing messagesdelete_message
- Remove messagesget_message_details
- Get specific message information
Room Management
create_room
- Create new Webex spaceslist_rooms
- Browse available roomsget_room_details
- Get room informationupdate_room
- Modify room settingsdelete_room
- Remove rooms
Team Operations
create_team
- Create teamslist_teams
- Browse teamsget_team_details
- Get team informationupdate_team
- Modify team settingsdelete_team
- Remove teams
Membership Management
create_membership
- Add people to roomslist_memberships
- View room membersupdate_membership
- Change member rolesdelete_membership
- Remove memberscreate_team_membership
- Add team memberslist_team_memberships
- View team members
People & Directory
get_my_own_details
- Get your profilelist_people
- Search for usersget_person_details
- Get user informationcreate_person
- Add new users (admin only)update_person
- Modify user detailsdelete_person
- Remove users (admin only)
Webhooks & Events
create_webhook
- Set up event notificationslist_webhooks
- Manage webhooksget_webhook_details
- Get webhook informationupdate_webhook
- Modify webhooksdelete_webhook
- Remove webhookslist_events
- Get activity logsget_event_details
- Get specific event information
Enterprise Features
create_room_tab
- Add tabs to roomslist_room_tabs
- View room tabsget_room_tab_details
- Get tab informationupdate_room_tab
- Modify tabsdelete_room_tab
- Remove tabscreate_attachment_action
- Handle form submissionsget_attachment_action_details
- Get attachment detailslist_ecm_folder
- Enterprise content managementget_ecm_folder_details
- Get ECM folder detailscreate_ecm_folder
- Create ECM configurationsupdate_ecm_linked_folder
- Modify ECM foldersunlink_ecm_linked_folder
- Remove ECM links
Development
Project Structure
Adding New Tools
- Create a new tool file in
tools/webex-public-workspace/webex-messaging/
- Follow the existing tool pattern with proper imports
- Add the tool path to
tools/paths.js
- 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
🔒 Pre-Commit Quality Gates
Automatic quality assurance using Husky pre-commit hooks:
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
- Fork the repository
- Create a feature branch
- Make your changes
- Tests run automatically on commit via pre-commit hooks
- Ensure all 118 tests pass
- 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
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
A Model Context Protocol (MCP) server that provides AI assistants with comprehensive access to Cisco Webex messaging capabilities.
- Overview
- Features
- Quick Start
- Configuration
- MCP Client Integration
- Available Tools
- Development
- Security
- Testing
- Contributing
- License
- Support
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityA 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 -13,4141,774TypeScriptMIT License
- -security-license-qualityA 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 -GoApache 2.0
- -securityAlicense-qualityA 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 -2PythonMIT License
- -securityAlicense-qualityA modern Model Context Protocol (MCP) server that enables AI assistants to collect interactive user feedback, supporting text and image-based responses.Last updated -PythonMIT License