The wxauto MCP Server enables AI tools to automate WeChat operations through 27 tools across 7 categories.
System Management
Initialize/configure the WeChat connection, check running status and account info
Activate and verify wxautox4 license, list all available tools
Messaging
Send text messages (with optional @mentions), URL/link cards, and bulk messages to multiple recipients
Retrieve current chat messages, historical messages, and new unread messages from chat windows
Contacts & Chat Management
Retrieve friends list (optionally with avatars), switch between chat windows, get current chat details
Navigate to the Contacts page
Sessions
List all sessions, get recently active group chats, filter by unread/mute status, get all unread sessions
File & Media Sharing
Send files, images, or entire directories (with optional file pattern filtering)
Check file existence before sending
Friend Requests
View incoming friend requests, accept them (with optional remark/tags), and add new friends via search keyword with custom message and permissions
Provides comprehensive WeChat automation capabilities including sending messages (text, images, files), managing contacts and friend requests, and retrieving chat history or session lists.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@wxauto MCP Serversend a message to Mom saying I'll be home for dinner at 7 PM"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
wxauto MCP Server
微信自动化 MCP (Model Context Protocol) 服务器,为 AI 开发工具提供微信自动化能力。
系统要求
Windows 11/10
Python 3.9+
微信已登录
wxautox4 激活
快速安装
pip install wxauto-mcp使用
一键自动安装(推荐)
wxauto-mcp --install这将自动配置 MCP Server 到 Claude Desktop 和 Claude Code,无需手动编辑配置文件。
生成配置文件(手动配置)
如果需要手动配置,运行:
# 生成配置文件到默认目录 (./mcp-configs)
wxauto-mcp --config
# 生成配置文件到指定目录
wxauto-mcp --config /path/to/configs
wxauto-mcp --config mcp-configs然后将生成的配置文件内容添加到 AI 应用中:
Claude Desktop 配置文件位置:
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Claude Code 配置文件位置:
%USERPROFILE%\.claude.json
Cursor:在 Settings 的 MCP 配置中添加
可用工具(27个)
系统工具(6个)
wechat_initialize- 初始化微信连接wechat_status- 获取微信运行状态wechat_activate- 激活 wxautox4wechat_check_activation- 检查激活状态wechat_list_tools- 列出所有可用工具get_my_info- 获取我的微信账号信息
消息工具(6个)
send_message- 发送文本消息send_url_card- 发送链接卡片get_messages- 获取当前聊天消息get_history- 获取历史消息get_next_new_message- 获取下一个聊天窗口的新消息send_bulk_messages- 批量发送消息
联系人工具(3个)
get_friends- 获取好友列表get_chat_info- 获取当前聊天信息switch_chat- 切换聊天窗口
会话工具(4个)
get_sessions- 获取会话列表get_recent_groups- 获取最近群聊filter_sessions- 筛选会话列表get_unread_sessions- 获取有未读消息的会话
文件工具(4个)
send_files- 发送文件send_image- 发送图片send_directory_files- 发送整个目录的文件check_file_exists- 检查文件是否存在
好友请求工具(3个)
get_new_friends- 获取新的好友请求列表accept_new_friend- 接受新的好友请求add_friend- 添加新好友
界面工具(1个)
switch_to_contact- 切换到联系人页面
常见问题
1. 激活
wxautox4 需要激活使用。请访问 https://docs.wxauto.org 获取激活密钥,然后:
# 设置环境变量
set WECHAT_LICENSE_KEY=your-license-key
# 或调用激活工具
wxauto-mcp-http
# 然后调用 wechat_activate 工具2. 权限问题
确保 Python 有访问微信进程的权限,建议以管理员身份运行。
3. 微信窗口
某些操作需要微信窗口在前台可见,请确保微信窗口未被最小化。
4. 配置文件位置
不同 AI 工具的配置文件位置:
Claude Desktop:
Windows:
%APPDATA%\Claude\claude_desktop_config.json
Claude Code:
Windows:
%USERPROFILE%\.claude.json
Cursor:
在 Settings → MCP 中添加配置
联系方式
GitHub Issues: louxinghao@gmail.com
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.