Quick Start

This guide will help you send your first message to WeCom using an AI assistant.

Step 1: Get Your Webhook URL

1. Open your WeCom group
2. Go to Group Settings → Group Bots → Add Bot
3. Copy the Webhook URL (format: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=xxx)

Step 2: Configure Your MCP Client

Add the server to your MCP client configuration:

Claude Desktop (macOS)

// ~/Library/Application Support/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "wecom": {
      "command": "uvx",
      "args": ["wecom-bot-mcp-server"],
      "env": {
        "WECOM_WEBHOOK_URL": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY"
      }
    }
  }
}

Claude Desktop (Windows)

// %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "wecom": {
      "command": "uvx",
      "args": ["wecom-bot-mcp-server"],
      "env": {
        "WECOM_WEBHOOK_URL": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY"
      }
    }
  }
}

Windsurf

// ~/.windsurf/config.json
{
  "mcpServers": {
    "wecom": {
      "command": "uvx",
      "args": ["wecom-bot-mcp-server"],
      "env": {
        "WECOM_WEBHOOK_URL": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY"
      }
    }
  }
}

Cline (VSCode)

// VSCode Settings > Cline > MCP Settings
{
  "mcpServers": {
    "wecom": {
      "command": "uvx",
      "args": ["wecom-bot-mcp-server"],
      "env": {
        "WECOM_WEBHOOK_URL": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY"
      }
    }
  }
}

Step 3: Restart Your MCP Client

After saving the configuration, restart your AI assistant (Claude Desktop, Cline, etc.) to load the new server.

Step 4: Send Your First Message

Now you can ask your AI assistant to send messages to WeCom:

Example Prompts

Send a simple message:

Send "Hello from AI!" to WeCom

Send a markdown message:

Send a markdown message to WeCom with today's weather forecast

Send with @mentions:

Send a meeting reminder to WeCom and mention user1 and user2

Send a file:

Send the file report.pdf to WeCom

Usage Examples

Scenario 1: Weather Update

USER: "What's the weather in Shenzhen today? Send it to WeCom"
ASSISTANT: "I'll check Shenzhen's weather and send it to WeCom"
[Uses send_message tool to send weather information]

Scenario 2: Meeting Reminder with @mentions

USER: "Send a reminder for the 3 PM project review, mention Zhang San and Li Si"
ASSISTANT: "I'll send the meeting reminder"
[Uses send_message with mentioned_list parameter]

Scenario 3: Send an Image

USER: "Send this chart image to WeCom"
ASSISTANT: "I'll send the image"
[Uses send_image tool]

Next Steps

• Message Types - Learn about all supported message types
• Multi-Bot Support - Configure multiple bots
• Environment Variables - Advanced configuration options