WeCom Bot
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 environme
What is WeCom Bot?
WeCom Bot is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 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...
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 environme
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A Python server implementation for WeCom (WeChat Work) bot t
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx wecom-bot-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use WeCom Bot
WeCom Bot MCP Server is a Python implementation of the Model Context Protocol that enables AI assistants to send messages, files, images, and rich template cards to WeCom (WeChat Work) group bots through their webhook API. Enterprise teams use it to have Claude automatically post deployment alerts, meeting reminders, project status updates, and formatted notification cards directly into WeChat Work group chats without any manual copy-paste. The server supports both single-bot and multi-bot configurations, making it suitable for organizations that have separate bots per team or environment.
Prerequisites
- Python 3.10 or higher installed
- A WeCom (WeChat Work) group with a bot configured and its webhook URL copied from group settings
- uvx (from the uv package manager) installed for the recommended run method
- An MCP-compatible client such as Claude Desktop or Cline
Obtain your WeCom bot webhook URL
In WeCom, open the group chat where you want the bot to post, go to group settings, and add or configure a bot. Copy the webhook URL provided — it looks like https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=<uuid>.
Install the server via Smithery (recommended)
Use the Smithery CLI to install and configure the server for Claude Desktop automatically.
npx -y @smithery/cli install wecom-bot-mcp-server --client claudeOr install manually with uvx
If you prefer manual setup, you can run the server directly with uvx and set the webhook URL as an environment variable.
WECOM_WEBHOOK_URL=https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY uvx wecom-bot-mcp-serverConfigure your MCP client manually
Add the server to your claude_desktop_config.json with the webhook URL set in the env block.
Restart your MCP client
Save the configuration and restart Claude Desktop. The WeCom bot tools will be available in your next conversation.
WeCom Bot Examples
Client configuration
Claude Desktop configuration for a single WeCom bot using the webhook URL environment variable.
{
"mcpServers": {
"wecom-bot": {
"command": "uvx",
"args": ["wecom-bot-mcp-server"],
"env": {
"WECOM_WEBHOOK_URL": "https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY",
"MCP_LOG_LEVEL": "INFO"
}
}
}
}Prompts to try
Example prompts for sending messages and notifications to WeCom group chats.
- "Send a message to WeCom: 'Deployment to production completed successfully at 3:42 PM'"
- "Send a WeCom reminder about the 3 PM project review meeting and mention Zhang San and Li Si"
- "Post a template card to WeCom with title 'Build Failed' and a link to the CI logs"
- "List all configured WeCom bots"
- "Send the file /tmp/report.pdf to the WeCom group"Troubleshooting WeCom Bot
Messages fail with a 400 or 403 error from the WeCom API
Verify the WECOM_WEBHOOK_URL is complete and correct. The key parameter in the URL is UUID-formatted. Re-copy it from WeCom group settings to rule out truncation.
Multi-bot configuration not working
For multiple bots, set WECOM_BOTS as a JSON object: `{"deploy": {"webhook_url": "...", "name": "Deploy Bot", "description": "CI/CD alerts"}}` or use individual WECOM_BOT_<NAME>_URL variables per bot.
Server fails to start with import errors
Ensure Python 3.10+ is installed and uvx is available. Run `uvx --version` to verify. If uvx is missing, install it with `pip install uv`.
Frequently Asked Questions about WeCom Bot
What is WeCom Bot?
WeCom Bot is a Model Context Protocol (MCP) server that 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 environme It connects AI assistants to external tools and data sources through a standardized interface.
How do I install WeCom Bot?
Follow the installation instructions on the WeCom Bot GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with WeCom Bot?
WeCom Bot works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is WeCom Bot free to use?
Yes, WeCom Bot is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
WeCom Bot Alternatives — Similar Communication Servers
Looking for alternatives to WeCom Bot? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
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.
Set Up WeCom Bot in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use 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.