wechat-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| host | No | Host for HTTP transports. | 127.0.0.1 |
| port | No | Port for HTTP transports. | 8000 |
| maximize | No | Maximize the WeChat window during operations. | false |
| log-level | No | Log level. Logs are written to stderr. | INFO |
| transport | No | Transport to use: stdio, sse, or streamable-http. | stdio |
| output-dir | No | Default output directory; alias for --folder-path. | |
| folder-path | No | Default output directory; alias for --output-dir. | |
| close-wechat | No | Close WeChat after each operation. | false |
| WECHAT_MCP_MAXIMIZE | No | Maximize the WeChat window during operations. | false |
| WECHAT_MCP_LOG_LEVEL | No | Log level. Logs are written to stderr. | INFO |
| WECHAT_MCP_OUTPUT_DIR | No | Default directory for output artifacts. Overridden by --folder-path/--output-dir. | |
| WECHAT_MCP_SEND_DELAY | No | Delay in seconds between individual message sends. | 0.2 |
| WECHAT_MCP_CLOSE_WECHAT | No | Close WeChat after each operation. | false |
| WECHAT_MCP_MAX_MESSAGES | No | Maximum number of messages to scan back when retrieving chat history by date. | 2000 |
| WECHAT_MCP_SEARCH_PAGES | No | Number of session-list scroll attempts when searching for a chat; 0 uses the top search box. | 5 |
| WECHAT_MCP_INITIAL_BATCH | No | Initial number of messages to scan; doubles when the target date is not reached. | 200 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| wechat_get_chat_historyA | 获取指定好友或群聊在某一天的聊天记录。 自动向上回溯历史消息直到覆盖目标日期，再按日期过滤，返回按时间正序排列的记录。 目标日期较久远时可调大 max_messages。 |
| wechat_send_messageB | 向单个微信好友或群聊发送一条消息。 |
| wechat_send_multiple_messagesB | 向单个微信好友或群聊连续发送多条消息。 |
| wechat_send_to_multiple_friendsB | 向多个微信好友或群聊发送消息（支持统一群发或分别发送）。 |
| wechat_send_filesB | 向单个好友或群聊发送本地文件（单个文件需小于 1GB）。 |
| wechat_get_contactsC | 获取通讯录中的好友、群聊、公众号、服务号或企业微信联系人。 |
| wechat_get_group_membersB | 获取指定群聊的成员昵称列表。 |
| wechat_search_chat_historyB | 用关键字在微信中全局搜索聊天记录。 |
| wechat_get_recent_sessionsB | 获取会话列表中的最近会话（名称、最后一条消息与时间）。 |
| wechat_check_new_messagesB | 检查会话列表中的新消息，返回有未读的会话及其最新内容。 |
| wechat_get_momentsC | 获取最近的朋友圈内容。 |
| wechat_post_momentsC | 发布一条朋友圈（文案 + 图片/视频）。 |
| wechat_export_chat_filesB | 导出与某个好友的聊天文件到本地目录（过期未下载的文件无法导出）。 |
| wechat_get_weixin_infoA | 获取当前微信的版本、wxid、数据目录及本服务器配置，用于排障。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| wechat_server_info | 本服务器的版本与运行配置。 |
TDQS
Scored across 14 tools
Most tools target distinct resources/actions, but the four send variants (send_message, send_multiple_messages, send_to_multiple_friends, send_files) create a cluster where single-vs-multiple-vs-recipients distinctions must be read carefully. Descriptions clarify the boundaries, so confusion is limited rather than severe.
All tools share a consistent wechat_ prefix followed by a verb_noun pattern (get_chat_history, send_message, post_moments, export_chat_files). No mixing of camelCase or divergent verb styles.
14 tools is well within the ideal 3-15 range and each tool maps to a concrete WeChat capability (messaging, contacts, history, moments, diagnostics). No obvious filler or redundancy.
Strong coverage of the messaging lifecycle (send, batch send, files, history, search, export), contacts, group members, sessions, and moments with both read and write. Minor gaps like friend management, group creation/administration, or message recall are absent but not essential to core workflows.