mcp-webex-messaging

An MCP server that exposes Webex messaging as tools for Claude and other MCP clients.

Tools

Tool	Description
send_webex_message	Send a direct message to a person by their email address
get_webex_messages	Retrieve recent messages from a 1:1 direct conversation

send_webex_message

Parameter	Type	Required	Description
recipient_email	string	yes	Email address of the recipient
message_text	string	yes	Message content
use_markdown	boolean	no	Send as Markdown (default: false)

get_webex_messages

Parameter	Type	Required	Description
recipient_email	string	yes	Email address of the person
max	integer	no	Max messages to retrieve (default: 10)

Configuration

The server reads config from the WEBEX_APCHAT_SECRET environment variable first, then falls back to ~/.config/apchat/env.

Example ~/.config/apchat/env:

WEBEX_APCHAT_SECRET=your-webex-personal-access-token
WEBEX_PERMITTED_USERS=you@example.com,colleague@example.com

WEBEX_APCHAT_SECRET (required)

Your Webex personal access token. Get one from developer.webex.com.

WEBEX_PERMITTED_USERS (optional)

Comma-separated whitelist of email addresses that can be messaged. If this key is absent or empty, all addresses are permitted. If set, any tool call targeting an address not on the list is rejected with an error.

Build

cargo build --release

The binary is at target/release/mcp-webex-messaging.

Use with Claude Code

Add to ~/.claude.json under mcpServers:

{
  "mcpServers": {
    "webex": {
      "command": "/path/to/mcp-webex-messaging",
      "args": []
    }
  }
}

Replace /path/to/mcp-webex-messaging with the absolute path to the compiled binary.

Run tests

cargo test