WinAutoWx

WinAutoWx provides a Windows-based WeChat automation MCP server that lets you control WeChat through HTTP API or an MCP client. You can send messages to individual contacts, chats, or multiple recipients, and you can orchestrate multi-message flows from an automated agent or script.

How to use

You run the local HTTP API service to expose messaging functionality, and you can also run an MCP server to enable stdio-based MCP clients to control the service. Use the HTTP API for direct programmatic access or connect via MCP to integrate into your automation workflow.

How to install

Prerequisites you need before installation are Windows 10/11 (64-bit recommended), Python 3.8–3.12 (64-bit recommended), and a signed-in WeChat for Windows.

Install dependencies using Python’s package manager.

Then start the HTTP API service and the MCP server as shown.

Configuration and usage notes

You can access the HTTP API at the local address 127.0.0.1 on port 8000. The primary endpoints you will use are the message sending endpoint and the control dump endpoint.

MCP configuration

[
  {
    "type": "http",
    "name": "wechat_http",
    "url": "http://127.0.0.1:8000",
    "args": []
  },
  {
    "type": "stdio",
    "name": "wechat_mcp",
    "command": "python",
    "args": ["mcp_server.py"],
    "env": [
      {"name": "WEIXIN_API_URL", "value": "http://127.0.0.1:8000"}
    ]
  }
]

Security and usage tips

Keep the WeChat main window visible on the primary desktop and avoid minimizing the window during automated operations. Start with a benign recipient like the File Transfer Helper to verify the flow before expanding to other contacts. If you are running a newer WeChat process (Weixin.exe), this setup is compatible.

Troubleshooting and notes

If you encounter issues with layout changes or control structures, enable verbose logging and share the output to diagnose. Ensure all services are running on the expected ports and that the API URL in your environment variables points to the correct address.

Available tools

send_messages

Send messages to one or more friends or chats using the specified backend (win32) with optional delays and control keys.

dump_controls

Export current UI control layout information from the WeChat automation backend to assist in debugging and scripting.