WeChat MCP
WeChat-MCP: let Openclaw/Claude/ChatGPT and other AI assistants read and reply to WeChat for you
What is WeChat MCP?
WeChat MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to wechat-mcp: let openclaw/claude/chatgpt and other ai assistants read and reply to wechat for you
WeChat-MCP: let Openclaw/Claude/ChatGPT and other AI assistants read and reply to WeChat for you
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- WeChat-MCP: let Openclaw/Claude/ChatGPT and other AI assista
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx wechat-mcpConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use WeChat MCP
WeChat MCP is a Python-based MCP server that lets AI assistants such as Claude, ChatGPT, and OpenClaw read and reply to WeChat messages on macOS by automating the WeChat desktop application via the Accessibility API and screen capture. It exposes tools for fetching chat history, sending replies, adding contacts, and posting Moments, enabling developers to build natural language WeChat automation workflows. The server also includes five purpose-built Claude Code sub-agents for chat summarization, auto-reply generation, message searching, multi-chat monitoring, and communication pattern analysis.
Prerequisites
- macOS (required — relies on macOS Accessibility API)
- Python 3.12 or higher
- WeChat desktop application installed, running, and logged in
- Accessibility permissions granted to your terminal in System Settings → Privacy & Security → Accessibility
- Claude Desktop, Claude Code, or another MCP-compatible AI client
Install WeChat MCP server via pip
Install the wechat-mcp-server package from PyPI. This provides the `wechat-mcp` executable used as the server command.
pip install wechat-mcp-serverGrant macOS Accessibility permissions
The server automates WeChat through the macOS Accessibility API. Go to System Settings → Privacy & Security → Accessibility and add your terminal application to the allowed list. This step is mandatory.
Ensure WeChat is open and logged in
The server controls the WeChat desktop app directly. WeChat must be running and you must be logged in before starting the MCP server or invoking any tools.
Configure Claude Desktop
Add the WeChat MCP server to your Claude Desktop configuration file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS).
{
"mcpServers": {
"wechat-mcp": {
"type": "stdio",
"command": "wechat-mcp"
}
}
}Register with Claude Code (alternative setup)
Claude Code users can add the server with a single terminal command instead of editing config files manually.
claude mcp add --transport stdio wechat-mcp -- wechat-mcpTest the connection
Ask your AI assistant to fetch messages from a specific WeChat contact. If the tool returns chat history, the server is working correctly.
WeChat MCP Examples
Client configuration (Claude Desktop)
Minimal Claude Desktop configuration for the WeChat MCP server installed via pip.
{
"mcpServers": {
"wechat-mcp": {
"type": "stdio",
"command": "wechat-mcp"
}
}
}Prompts to try
Once connected, use natural language to control WeChat through your AI assistant.
- "Read the last 10 messages from my chat with Alice and summarize them"
- "Reply to the Team chat: The meeting is postponed to 3pm"
- "Check all my group chats and flag any messages that need urgent replies"
- "Search my chat history with Bob for any messages about the project deadline"
- "Post a WeChat Moment saying: Great lunch today!"
- "Add contact with WeChat ID wxid_xyz789 and introduce myself"Troubleshooting WeChat MCP
Server cannot control WeChat — Accessibility API permission error
Open System Settings → Privacy & Security → Accessibility. Ensure your terminal app (Terminal.app, iTerm2, VS Code terminal, etc.) is listed and toggled on. You may need to remove and re-add it. Restart the terminal after granting permission.
fetch_messages_by_chat returns empty results for a known chat
Chat lookup uses exact display name matching. Verify you are using the exact name as shown in WeChat (including Chinese characters). The chat must also be visible in WeChat's sidebar — scroll down to load older chats if needed.
wechat-mcp command not found after pip install
Check that your pip scripts directory is in PATH: run `pip show wechat-mcp-server` to find the Scripts location. Add it to PATH in ~/.zshrc or ~/.bash_profile. Alternatively use `python -m wechat_mcp` as the command in your config.
Frequently Asked Questions about WeChat MCP
What is WeChat MCP?
WeChat MCP is a Model Context Protocol (MCP) server that wechat-mcp: let openclaw/claude/chatgpt and other ai assistants read and reply to wechat for you It connects AI assistants to external tools and data sources through a standardized interface.
How do I install WeChat MCP?
Follow the installation instructions on the WeChat MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with WeChat MCP?
WeChat MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is WeChat MCP free to use?
Yes, WeChat MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.
WeChat MCP Alternatives — Similar Communication Servers
Looking for alternatives to WeChat MCP? 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 MCP 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 MCP?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.