Webex MCP Server (Go)

A high-performance Go implementation of the Webex MCP (Model Context Protocol) Server, providing AI assistants with comprehensive access to Cisco Webex messaging, collaboration, and enterprise features.

🚀 Quick Setup for Claude Desktop

1. Build the Server

make build

2. Configure Claude Desktop

Find your Claude Desktop config file:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json
• Linux: ~/.config/Claude/claude_desktop_config.json

Add this configuration:

{
  "mcpServers": {
    "webex": {
      "command": "/absolute/path/to/your/webex-mcp-server/build/webex-mcp-server",
      "args": ["-env", "/absolute/path/to/your/webex-mcp-server/.env", "-all-tools"],
      "env": {
        "WEBEX_PUBLIC_WORKSPACE_API_KEY": "your-webex-token"
      }
    }
  }
}

3. Restart Claude Desktop

• Completely quit Claude (not just close window)
• Restart Claude Desktop

4. Start Using Webex with Claude!

In Claude, you can now say:

• "List my Webex rooms"
• "Send a message to the Engineering team room"
• "Show recent messages in Project Alpha"
• "Create a new room called Planning Meeting"
• "Add john.doe@company.com to the Marketing team"

✨ Features

• Complete Webex API Integration: 53+ tools covering messaging, rooms, teams, people, webhooks, and enterprise features
• High-Performance Architecture: Built with Go for optimal speed and resource efficiency
• Multiple Transport Modes: Support for both stdio and SSE (Server-Sent Events) transports
• MCP Protocol Compliance: Uses the official Model Context Protocol Go SDK
• Advanced Tool Management: Comprehensive tool registry with modular organization
• Optimized HTTP Client:
  • Standard net/http with intelligent connection pooling
  • Automatic connection reuse and keep-alive
  • Configurable timeouts and retry logic
  • Built for enterprise-scale operations

📋 Prerequisites

• Go 1.24+ (current version: 1.24.0)
• Webex API Token - Get yours from developer.webex.com
• Docker (optional) - For containerized deployment

🛠️ Installation

1. Clone the repository:

git clone https://github.com/raja-aiml/webex-mcp-server.git
cd webex-mcp-server

2. Install dependencies:

make deps

3. Set up environment variables:

# Copy the example environment file
cp .env.example .env

# Edit .env and add your Webex API token
# WEBEX_PUBLIC_WORKSPACE_API_KEY=your_webex_api_token_here

⚙️ Configuration

Create a .env file in the project root with the following variables:

# Required: Your Webex API token
WEBEX_PUBLIC_WORKSPACE_API_KEY=your_webex_api_token_here

# Optional: Webex API base URL (default: https://webexapis.com/v1)
WEBEX_API_BASE_URL=https://webexapis.com/v1

# Optional: Server port for HTTP mode (default: 3001)
PORT=3001

🎯 Usage Modes

Claude Desktop Integration (Recommended)

This MCP server is optimized for Claude Desktop.

1. Build the server:

make build

2. Add to Claude Desktop config:

{
  "mcpServers": {
    "webex": {
      "command": "/full/path/to/webex-mcp-server/build/webex-mcp-server",
      "args": ["-env", "/full/path/to/webex-mcp-server/.env", "-all-tools"],
      "env": {
        "WEBEX_PUBLIC_WORKSPACE_API_KEY": "your-token"
      }
    }
  }
}

3. Restart Claude and start using:

• "List my Webex rooms"
• "Send a message to [room name]"
• "Show recent messages"
• "Create a team called Engineering"

Development and Testing Modes

Local Development (stdio mode):

make run
# or
make mcp-local

HTTP/SSE Mode (for debugging):

make run http
# Check health endpoint
curl http://localhost:3001/health

Docker Mode:

# Build and run in Docker
make mcp-docker

# Or use docker-compose for HTTP mode
make

... [View full README on GitHub](https://github.com/raja-aiml/webex-mcp-server#readme)