wechat

WeChat MCP is a control server that lets MCP clients interact with WeChat running on Windows through the WeChatFerry-based tooling. Once the MCP server is running, clients can connect via HTTP MCP at the default endpoint http://localhost:10888/mcp (or http://localhost:18060/mcp for other clients that support the generic HTTP MCP endpoint). The server exposes a toolkit of capabilities for managing a Windows WeChat instance, including checking login status, sending messages (text, cards, images, or files), querying and managing contacts and group chats, and performing actions such as inviting or removing members from groups, revoking or forwarding messages, and refreshing Moments data. You can access the full list of available tools and their purposes in the provided MCP Tools table, for example check_login_status, send_text_message, get_chat_rooms, invite_chat_room_members, remove_chat_room_members, revoke_message, forward_message, get_contacts, and many others. To use these tools, connect the MCP client to the server's HTTP endpoint and invoke the tool commands with the appropriate parameters as documented by your MCP client. The README also demonstrates client integrations across Codex CLI, Claude Code CLI, and VSCode, showing how to register the server with each client and perform common actions like listing MCP connections and sending commands.

Prerequisites:

• A Windows machine with WeChat installed and accessible via WeChatFerry integration as described by the project.
• Access to the internet to download either a precompiled release or to build from source.

Installation options:

1. Download precompiled release

   • Go to the project's Releases page on GitHub and download the Windows binary (wechat-mcp.exe).
   • Run the executable to start the MCP server.

2. Build from source

   • Prerequisites: Go toolkit installed on your system.
   • Clone the repository: git clone https://github.com/lw396/wechat-mcp.git cd wechat-mcp
   • Install dependencies (modules): go mod tidy
   • Build for Windows (amd64): GOOS=windows GOARCH=amd64 go build -o wechat-mcp.exe .
   • Run the server: ./wechat-mcp.exe

Notes:

• The README indicates the server runs as a Windows executable. Ensure you run it on Windows or in a Windows-compatible environment.
• By default, clients connect to http://localhost:10888/mcp. If you need to support other clients, http://localhost:18060/mcp is also advertised in the documentation.

Tips and common issues:

• The MCP server is Windows-only for direct WeChat integration via WeChatFerry. If you are on macOS or Linux, you may need to run a Windows VM or containerized Windows environment to use the server.
• Ensure WeChat version compatibility as noted in the project (the tool supports specific WeChat Windows versions).
• If you see connection issues, verify that the server is running and listening on the expected port (10888 by default). Some clients also support a secondary HTTP endpoint at 18060/mcp; use that if your client requires it.
• The MCP feature set is extensive, including group management (invite, add, remove members), message actions (send, revoke, forward, pat), and information retrieval (contacts, chat rooms, members, aliases). Review the Tools table in README to pick the exact command you need for a given task.
• When using the Codex CLI or Claude Code CLI examples, ensure the MCP server URL matches your deployment and that the MCP is already running before issuing commands.