MCP WeCom Bot

v1.0.0β€’Communicationβ€’stable

πŸš€ ☁️ - An MCP server application that sends various types of messages to the WeCom group robot.

mcp-wecombotmcpai-integration
Share:
37
Stars
0
Downloads
0
Weekly
0/5

What is MCP WeCom Bot?

MCP WeCom Bot is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to πŸš€ ☁️ - an mcp server application that sends various types of messages to the wecom group robot.

πŸš€ ☁️ - An MCP server application that sends various types of messages to the WeCom group robot.

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • πŸš€ ☁️ - An MCP server application that sends various types of

Use Cases

Send various types of messages to WeCom group robots. Automate messaging through MCP integration.
gotoolkits

Maintainer

LicenseGPL-3.0
Languagego
Versionv1.0.0
UpdatedMar 23, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx mcp-wecombot

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use MCP WeCom Bot

MCP WeCom Bot Server is a Go-based MCP server that enables AI assistants to send messages directly to WeCom (WeChat Work) group robots via the WeCom Webhook API. It supports multiple message types β€” plain text, Markdown, images, news cards, template cards, and file uploads β€” making it useful for AI-driven notifications, status updates, alert dispatching, and automated team communication within WeCom workspaces. Developers and DevOps teams use it to have Claude or other AI assistants post summaries, alerts, and reports to WeCom groups as part of automated workflows.

Prerequisites

  • A WeCom (WeChat Work) account with a group robot configured (see https://developer.work.weixin.qq.com/document/path/91770)
  • The WeCom group robot Webhook key (the UUID in the webhook URL after '?key=')
  • A pre-compiled mcp-wecombot-server binary (download from releases or build from source with Go and make)
  • An MCP client such as Claude Desktop
1

Create a WeCom group robot and get the Webhook key

In WeCom, open a group chat, click the group settings (three dots), select Group Robots > Add Robot, copy the Webhook URL. The key is the UUID in the URL: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY_HERE

2

Install the server binary

Either download a pre-compiled release binary from the GitHub releases page, or build from source. Symlink or copy the binary into your PATH.

# Build from source
git clone https://github.com/gotoolkits/mcp-wecombot-server.git
cd mcp-wecombot-server && make build
sudo ln -s $PWD/dist/mcp-wecombot-server_linux_amd64 /usr/local/bin/mcp-wecombot-server

# Or install via Smithery
npx -y @smithery/cli install @gotoolkits/mcp-wecombot-server --client claude-desktop
3

Configure your MCP client

Add the server to claude_desktop_config.json with the WECOM_BOT_WEBHOOK_KEY environment variable set to your robot's Webhook key.

{
  "mcpServers": {
    "mcp-wecombot-server": {
      "command": "mcp-wecombot-server",
      "env": {
        "WECOM_BOT_WEBHOOK_KEY": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
      }
    }
  }
}
4

Restart Claude Desktop

Save the config file and restart Claude Desktop. The send_text, send_markdown, send_image, send_news, send_template_card, and upload_file tools will be available.

MCP WeCom Bot Examples

Client configuration

Full claude_desktop_config.json entry for MCP WeCom Bot Server.

{
  "mcpServers": {
    "mcp-wecombot-server": {
      "command": "mcp-wecombot-server",
      "env": {
        "WECOM_BOT_WEBHOOK_KEY": "693a1234-7a0c-4bc4-97a0-0ec2abcd5aaa"
      }
    }
  }
}

Prompts to try

Example prompts that send messages to your WeCom group via the robot.

- "Send a text message to WeCom: 'Deployment to production completed successfully.'"
- "Send a Markdown message to WeCom with a heading '# Daily Report' and today's build status."
- "Send a news card to WeCom with title 'Incident Alert', description 'Database latency spike detected', and link to the dashboard."
- "Upload the error log file at /tmp/app.log to WeCom."
- "Send a template card to WeCom summarizing the test results."

Troubleshooting MCP WeCom Bot

Messages fail with HTTP 400 or 'invalid webhook key'

The WECOM_BOT_WEBHOOK_KEY value must be only the UUID portion of the URL, not the full URL. Extract just the key after '?key=' from the WeCom robot webhook URL and set that as the env value.

'mcp-wecombot-server: command not found' when starting Claude Desktop

The binary is not on the system PATH that Claude Desktop sees. Either use the full absolute path as the 'command' value (e.g., '/usr/local/bin/mcp-wecombot-server'), or ensure the binary's directory is in the PATH loaded by your shell profile.

Image or file messages fail to send

Images sent via send_image must be Base64-encoded and under WeCom's size limit (2MB). For file uploads, use the upload_file tool which handles the multipart upload. Ensure the file path is accessible to the process running the MCP server.

Frequently Asked Questions about MCP WeCom Bot

What is MCP WeCom Bot?

MCP WeCom Bot is a Model Context Protocol (MCP) server that πŸš€ ☁️ - an mcp server application that sends various types of messages to the wecom group robot. It connects AI assistants to external tools and data sources through a standardized interface.

How do I install MCP WeCom Bot?

Follow the installation instructions on the MCP WeCom Bot GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with MCP WeCom Bot?

MCP WeCom Bot works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is MCP WeCom Bot free to use?

Yes, MCP WeCom Bot is open source and available under the GPL-3.0 license. You can use it freely in both personal and commercial projects.

Browse More Communication MCP Servers

Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "mcp-wecombot": { "command": "npx", "args": ["-y", "mcp-wecombot"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide β†’

Ready to use MCP WeCom Bot?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides