WeCom Bot MCP Server

Name: WeCom Bot MCP Server
Author: loonghao

@loonghao

About WeCom Bot MCP Server

A Python server implementation for WeCom (WeChat Work) bot that follows the Model Context Protocol (MCP). This server provides a standardized interface for handling automated messaging and context-aware interactions within enterprise WeChat environments.

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "wecom-bot-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "wecom-bot-mcp-server",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is WeCom Bot MCP Server?

A Model Context Protocol (MCP) server for WeCom (WeChat Work) bot. It enables AI assistants to send messages, files, images, and template cards to WeCom groups through webhook URLs.

How to use WeCom Bot MCP Server?

Install via uvx or with Smithery for Claude Desktop, then configure the WECOM_WEBHOOK_URL environment variable. The server runs automatically when the MCP client starts, allowing you to interact through natural language. For developers, the package also provides a direct Python API.

Key features of WeCom Bot MCP Server

Support for multiple message types (markdown, image, file, template card)
Multi-bot configuration and management
@mention support via user ID or phone number
Message history tracking
Configurable logging system with cross-platform log storage
Pydantic-based data validation

Use cases of WeCom Bot MCP Server

Send weather updates or notifications to a WeCom group
Send meeting reminders with @mentions for specific attendees
Deliver files (reports, logs) or images (charts) to a group
Send critical alerts or CI/CD notifications to designated bots
Send template card notifications with action buttons or news-style cards

FAQ from WeCom Bot MCP Server

What are the prerequisites to use WeCom Bot MCP Server?

Python 3.10+ and a WeCom Bot Webhook URL obtained from a WeCom group’s bot settings.

How can I configure multiple bots?

Set the WECOM_BOTS environment variable with a JSON object containing each bot’s name and webhook URL, or use individual WECOM_BOT_<name>_URL variables. The WECOM_WEBHOOK_URL variable can also be used as a default bot.