wxauto-mcp

What is wxauto-mcp?

wxauto-mcp is a Model Context Protocol (MCP) server that enables large language models to interact with the WeChat client on Windows. It uses the wxauto library to send and receive WeChat messages, allowing LLMs to automate WeChat conversations.

How to use wxauto-mcp?

Install uv, clone the repository, run uv sync in the project directory, then configure the server in Claude Desktop or Cursor by adding a JSON entry that points uv to run wxauto_mcp.py with the correct path.

Key features of wxauto-mcp?

• send_message: Send a message to a contact or group (requires msg and to; optional at for @-mention).
• get_all_messages: Retrieve chat history for a contact or group (requires who; optional load_more for older messages).
• Only works on Windows with a specific WeChat version (see wxauto documentation).
• Uses the wxauto library for all WeChat interaction.
• Configured as an MCP server for Claude Desktop or Cursor.

Use cases of wxauto-mcp?

• Automate sending WeChat messages to contacts or groups.
• Retrieve and analyze recent chat history from a specific conversation.
• Build AI-powered assistants that respond to messages in WeChat.
• Trigger WeChat notifications from other automated workflows.

FAQ from wxauto-mcp

Does wxauto-mcp work on macOS or Linux?

No, this MCP server only works on Windows systems.

What WeChat version is required?

The server has a version restriction on WeChat; refer to the wxauto documentation for the supported environment.

How do I install wxauto-mcp?

Install uv, clone the repository, run uv sync, then add the server configuration to Claude Desktop or Cursor using the provided JSON example.

Can I send messages to group chats?

Yes, use the send_message tool with the group name as the to parameter. You can also @-mention someone with the optional at parameter.

Does wxauto-mcp store chat data?

No, the server only retrieves messages from the WeChat client on demand; it does not store any history or data persistently.