home / mcp / wechat mcp server

WeChat MCP Server

已全面支持NT架构，微信MCP，打造您的专属提醒助手

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "1052666-wechat-mcp-server": {
      "command": "python",
      "args": [
        "C:/path/to/WeChat-MCP-Server/src/mcp_server.py"
      ],
      "env": {
        "ENV": "{}"
      }
    }
  }
}

This WeChat MCP Server enables automating WeChat messaging through the Model Context Protocol (MCP). It connects your AI assistant to WeChat, allowing you to send text messages to contacts or groups, schedule messages, and integrate with automated workflows while adhering to MCP standards.

How to use

You connect the MCP Server to your AI assistant, then request messaging actions by name, such as sending a text to a contact or scheduling a message. Use the available tools through the MCP interface to trigger WeChat actions from your AI workflows. You can pair the server with automation jobs, chatbots, and Cloud Code actions to keep teammates informed or to notify you about important events.

How to install

Prerequisites: ensure you have Windows operating system and Python 3.8 or newer installed. You will also need a WeChat client that is started and logged in.

# Clone the project
git clone https://github.com/1052666/WeChat-MCP-Server.git
cd WeChat-MCP-Server

# Install Python dependencies
pip install -r requirements.txt

Configuration and usage notes

Configure the MCP connection so your AI assistant can communicate with the WeChat MCP Server. The following example shows how to configure the MCP server entry for your assistant, using python to run the MCP server script.

{
  "mcpServers": {
    "wechat": {
      "command": "python",
      "args": ["C:/path/to/WeChat-MCP-Server/src/mcp_server.py"],
      "env": {}
    }
  }
}

Available tools

The server exposes tools you can call from your AI assistant to interact with WeChat. Use these tools by name and provide the required arguments in your MCP requests.

Troubleshooting and tips

Ensure the WeChat client is running and visible. If message sending fails, verify that the target contact or group exists and is in your chat list. The server includes logs to help diagnose issues, including request handling status and the outcome of WeChat operations.

Development and expansion

You can extend the server by registering new tools in the core MCP implementation and adding corresponding actions in the WeChat controller. This lets you broaden the range of WeChat interactions beyond sending text messages.

Notes on compatibility and scope

This server is designed for Windows and relies on the WeChat client being available. It supports multiple WeChat window layouts and includes an input mechanism that minimizes issues with input method editors (IME). It focuses on text messaging and scheduling within MCP workflows.

Security and safety reminders

Automating messaging with WeChat can involve security and privacy considerations. Use this tool responsibly, respect user consent, and comply with applicable terms of service and local laws.

If you run into issues

Check that the WeChat window is not minimized and is visible on screen. Confirm the target contact or group is correct and that the WeChat process is active. Review logs from the MCP server to identify where the failure occurs.

Available tools

send_wechat_message

Sends a text message to a specified WeChat contact or group with the given content.

schedule_wechat_message

Schedules a text message to be sent after a specified delay to a specific contact or group.