wechat-mcp
Allows AI agents to control Windows WeChat, including reading chats and contacts, sending messages, making voice/video calls, searching, and monitoring for new messages.
Click on "Deploy 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., "@wechat-mcpcheck for new WeChat messages"
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.
wechat-mcp
基于 FastMCP + uiautomation 的 Windows 微信 MCP 服务器。让 Claude Code / 任意 MCP 客户端能直接操控 Windows 微信:读会话、读/发消息、监听新消息。
功能
📋 会话 / 联系人:主页可见会话(含未读数、最新消息预览)、全量会话、全量联系人、缓存读取
💬 读消息:按会话读取(带发送者前缀 + 时间标签);
recent=N只要最近 N 条;load_more逐批加载更早历史✉️ 发消息 / 通话:发送文本、发起 / 挂断语音视频通话
🔍 搜索:用微信自带搜索框搜联系人 / 群聊 / 公众号(支持拼音)
📡 监听新消息:后台线程轮询主页会话,
monitorStart+monitorPoll组合,发现新消息自动停止并返回
Related MCP server: WinAutoWx
环境要求
Windows + 已登录的微信 PC 版(微信窗口要能打开)
Python 3.10+(实测 3.14)
安装
cd agent_use_weChat
python -m venv .venv
.venv/Scripts/pip install -r requirements.txt配置微信路径(写入 .env):
WE_CHAT_PATH=C:\你的\WeChat.exe注册到 Claude Code
claude mcp add use_weChat -- <项目路径>\.venv\Scripts\python.exe <项目路径>\src\main.py工具一览
工具 | 作用 |
| 打开微信 |
| 主页会话(含未读 / 预览; |
| 全量联系人 / 缓存列表 |
| 搜索联系人 / 群聊 / 公众号 |
| 读消息(窗口没开会自动打开) |
| 发文本 / 语音视频通话 / 挂断 |
| 显式打开会话窗口 |
| 监听主页新消息 |
说明
get_msg_list窗口没开会自动打开;sendMsg需要窗口已开(先get_msg_list或openPartnerWindow)监听用
monitorStart+monitorPoll组合(MCP 单次调用有 60s 超时,别用长阻塞调用)基于 uiautomation 界面自动化驱动微信:无注入、无解库、不碰进程内存
This server cannot be deployed
Maintenance
Related MCP Connectors
Drive WhatsApp from any MCP client: pair devices, send text and media, manage contacts and groups.
Let Claude or ChatGPT search, read and send your WhatsApp messages over MCP. OAuth sign-in.
Your own WhatsApp as an MCP server: read, search and send from any MCP client.
WhatsApp (Web + Business API), SMS, contacts, and call records via 2Chat's MCP server.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables automated WeChat operations on Windows through pywinauto, allowing users to send messages to multiple friends or groups programmatically. Provides tools for searching contacts, sending bulk messages, and controlling WeChat interface elements via MCP protocol.17-
- FlicenseNot gradedqualityDmaintenanceAn MCP server for automating WeChat on Windows, enabling sending messages to friends or groups and exporting UI controls via natural language.-
- FlicenseNot gradedqualityDmaintenanceMCP server for WeChat PC automation, enabling message sending, voice/video calls, and AI-powered listening through Cursor or WorkBuddy.2-
- AlicenseNot gradedqualityDmaintenanceEnables AI clients to automate Windows desktop applications through window manipulation, image recognition, OCR, keyboard/mouse simulation, and memory operations via the MCP protocol.MIT