Enables AI assistants to send WeChat messages through automation, supporting both immediate and scheduled message delivery to contacts and groups using the Model Context Protocol standard.
What is WeChat?
WeChat is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to enables ai assistants to send wechat messages through automation, supporting both immediate and scheduled message delivery to contacts and groups using the model context protocol standard.
Enables AI assistants to send WeChat messages through automation, supporting both immediate and scheduled message delivery to contacts and groups using the Model Context Protocol standard.
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- Enables AI assistants to send WeChat messages through automa
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx wechat-mcp-serverConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use WeChat
WeChat MCP Server is a Python-based MCP server that uses the macOS Accessibility API and screen capture to give AI assistants programmatic control over the WeChat desktop application. It enables fetching recent messages from any chat, sending automated replies, publishing text-only Moments posts, and adding contacts — all through natural language commands. The server ships with five specialized Claude Code sub-agents for common WeChat automation workflows including summarizing chats, auto-replying, searching history, monitoring multiple chats, and analyzing communication patterns.
Prerequisites
- macOS (required — uses macOS Accessibility API)
- Python 3.12 or higher
- WeChat desktop application installed and running
- Accessibility permissions granted to your terminal app in System Settings → Privacy & Security → Accessibility
- Claude Desktop, Claude Code, or another MCP-compatible client
Install the WeChat MCP server via pip
Install the package from PyPI. This provides the `wechat-mcp` command that serves as the MCP server entry point.
pip install wechat-mcp-serverGrant macOS Accessibility permissions
The server controls WeChat via the Accessibility API, which requires explicit permission. Open System Settings, navigate to Privacy & Security → Accessibility, and add your terminal application (Terminal.app, iTerm2, or your IDE's terminal).
Ensure WeChat is running
The MCP server controls the WeChat desktop app directly, so WeChat must be open and logged in before starting the server. Keep it running in the background during use.
Add to Claude Desktop configuration
Edit your Claude Desktop config file to register the WeChat MCP server. The server uses stdio transport by default.
{
"mcpServers": {
"wechat-mcp": {
"type": "stdio",
"command": "wechat-mcp"
}
}
}Register with Claude Code (alternative)
If you prefer Claude Code over Claude Desktop, add the server using the mcp add command.
claude mcp add --transport stdio wechat-mcp -- wechat-mcpVerify the tools are available
Start a conversation in your MCP client and ask it to list available WeChat tools. You should see fetch_messages_by_chat, reply_to_messages_by_chat, add_contact_by_wechat_id, and publish_moment_without_media.
WeChat Examples
Client configuration (Claude Desktop)
Complete Claude Desktop configuration for the WeChat MCP server installed via pip.
{
"mcpServers": {
"wechat-mcp": {
"type": "stdio",
"command": "wechat-mcp"
}
}
}Prompts to try
Use these natural language commands once the server is connected to your AI assistant.
- "Fetch the last 20 messages from my chat with John"
- "Reply to the Family group chat with: I'll be there at 7pm"
- "Summarize the unread messages in my Work group"
- "Add contact with WeChat ID wxid_abc123 and send a friend request"
- "Post a Moments update saying: Enjoying the weekend!"
- "Check all my group chats and tell me which ones have urgent messages"Troubleshooting WeChat
Server reports Accessibility API permission denied or cannot find WeChat window
Open System Settings → Privacy & Security → Accessibility and confirm your terminal (or IDE) is in the allowed list with the toggle enabled. Restart your terminal after granting permission. Make sure WeChat is open and fully loaded before invoking any tool.
fetch_messages_by_chat returns no messages or wrong chat
The tool uses exact name matching for chat search. Use the exact display name of the contact or group as it appears in WeChat. Chinese characters must match exactly. If the chat is not recently active, scroll it into view in WeChat before fetching.
wechat-mcp command not found after pip install
Ensure your Python scripts directory is in PATH. Run `pip show wechat-mcp-server` to find the install location. Alternatively use `python -m wechat_mcp` or install with `pip install --user` and add ~/.local/bin to PATH.
Frequently Asked Questions about WeChat
What is WeChat?
WeChat is a Model Context Protocol (MCP) server that enables ai assistants to send wechat messages through automation, supporting both immediate and scheduled message delivery to contacts and groups using the model context protocol standard. It connects AI assistants to external tools and data sources through a standardized interface.
How do I install WeChat?
Follow the installation instructions on the WeChat GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with WeChat?
WeChat works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is WeChat free to use?
Yes, WeChat is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
WeChat Alternatives — Similar Communication Servers
Looking for alternatives to WeChat? Here are other popular communication servers you can use with Claude, Cursor, and VS Code.
Slack
★ 86.1kEnables interaction with Slack workspaces through comprehensive channel management, messaging, user management, file uploads, and Block Kit formatting. Features secure credential storage via macOS Keychain and supports all major Slack operations incl
LibreChat
★ 37.3kEnhanced ChatGPT Clone: Features Agents, MCP, DeepSeek, Anthropic, AWS, OpenAI, Responses API, Azure, Groq, o1, GPT-5, Mistral, OpenRouter, Vertex AI, Gemini, Artifacts, AI model switching, message search, Code Interpreter, langchain, DALL-E-3, OpenA
Note Gen
★ 11.9kA cross-platform Markdown AI note-taking software.
DeepChat
★ 5.8k🐬DeepChat - A smart assistant that connects powerful AI to your personal world
WhatsApp MCP
★ 5.7kConnects AI assistants to the official Meta WhatsApp Cloud API for managing conversations and sending various message types through natural language. It provides tools for media management, template messages, and real-time webhook processing without
Apple
★ 3.1kEnables interaction with Apple apps like Messages, Notes, and Contacts through the MCP protocol to send messages, search, and open app content using natural language.
Browse More Communication MCP Servers
Explore all communication servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.
Set Up WeChat in Your Editor
Choose your AI client for step-by-step setup instructions.
Quick Config Preview
Add this to your claude_desktop_config.json or .cursor/mcp.json
Ready to use WeChat?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.