Skip to content

WeCom Bot MCP ServerEnterprise WeChat Bot for AI Assistants

A Model Context Protocol (MCP) compliant server for WeCom Bot

WeCom Bot Logo

Quick Installation

bash
npx -y @smithery/cli install wecom-bot-mcp-server --client claude
bash
pip install wecom-bot-mcp-server
bash
uvx wecom-bot-mcp-server

Basic Configuration

json
{
  "mcpServers": {
    "wecom": {
      "command": "uvx",
      "args": ["wecom-bot-mcp-server"],
      "env": {
        "WECOM_WEBHOOK_URL": "your-webhook-url"
      }
    }
  }
}

Multi-Bot Configuration

Configure multiple bots for different purposes (alerts, CI/CD, team updates):

json
{
  "mcpServers": {
    "wecom": {
      "command": "uvx",
      "args": ["wecom-bot-mcp-server"],
      "env": {
        "WECOM_WEBHOOK_URL": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=default",
        "WECOM_BOTS": "{\"alert\": {\"name\": \"Alert Bot\", \"webhook_url\": \"https://...?key=alert\"}, \"ci\": {\"name\": \"CI Bot\", \"webhook_url\": \"https://...?key=ci\"}}"
      }
    }
  }
}
bash
# JSON configuration (recommended)
export WECOM_BOTS='{
  "alert": {"name": "Alert Bot", "webhook_url": "https://...?key=alert"},
  "ci": {"name": "CI Bot", "webhook_url": "https://...?key=ci"}
}'

# Or individual variables
export WECOM_BOT_ALERT_URL="https://...?key=alert"
export WECOM_BOT_CI_URL="https://...?key=ci"

JSON Escape Tools

The WECOM_BOTS value requires JSON escaping. Use these online tools to convert your JSON:

Use list_wecom_bots tool to discover all configured bots. Learn more →

Released under the MIT License.