WeChat Robot
A WeChat robot server based on the Model Context Protocol that enables AI agents to send and receive messages and manage typing status. It provides tools for QR code login, long-polling message retrieval, and persistent state management across variou
What is WeChat Robot?
WeChat Robot is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to wechat robot server based on the model context protocol that enables ai agents to send and receive messages and manage typing status. it provides tools for qr code login, long-polling message retrieva...
A WeChat robot server based on the Model Context Protocol that enables AI agents to send and receive messages and manage typing status. It provides tools for QR code login, long-polling message retrieval, and persistent state management across variou
This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.
Features
- A WeChat robot server based on the Model Context Protocol th
Use Cases
Maintainer
Works with
Installation
Manual Installation
npx mcp-wechatConfiguration
Configuration Details
claude_desktop_config.json
Performance
Response Metrics
Resource Usage
How to Set Up and Use WeChat Robot
mcp-wechat-server is a TypeScript MCP server that turns a WeChat account into an AI-controlled messaging interface, allowing AI agents to send and receive messages, manage typing indicators, and handle QR code login through the Model Context Protocol. It uses long-polling to retrieve new messages and persists login credentials locally, making it suitable for building automated WeChat bots or AI-powered chat assistants without a dedicated WeChat Business account. Developers building personal assistant bots, automated notification systems, or AI-driven customer support tools for WeChat will find this server a straightforward starting point.
Prerequisites
- Bun runtime version 1.0.0 or higher installed (https://bun.sh)
- A personal WeChat account with mobile app access for QR code scanning
- An MCP client such as Claude Desktop or OpenCode
- Basic familiarity with WeChat's web login flow
Install Bun runtime
mcp-wechat-server requires Bun (not Node.js). Install it using the official one-line installer if it is not already present.
curl -fsSL https://bun.sh/install | bashAdd the server to your MCP client configuration
Edit your claude_desktop_config.json to register mcp-wechat-server. The server is run via bunx, which downloads and runs the package automatically.
{
"mcpServers": {
"wechat": {
"command": "bunx",
"args": ["mcp-wechat-server"]
}
}
}Restart your MCP client
Restart Claude Desktop or your MCP client so it registers the new WeChat server and its tools become available.
Log in to WeChat via QR code
Ask your AI client to call the login_qrcode tool. It will return a QR code that you scan with your WeChat mobile app. Then call check_qrcode_status to confirm the login completed. Credentials are saved automatically to ~/.mcp-wechat-server/.
Poll for and respond to messages
Use get_messages to retrieve incoming messages (supports blocking wait), send_typing to show a typing indicator, then send_text_message to reply. Call send_typing again to clear the indicator after sending.
WeChat Robot Examples
Client configuration
claude_desktop_config.json entry for mcp-wechat-server using bunx. No additional environment variables are required.
{
"mcpServers": {
"wechat": {
"command": "bunx",
"args": ["mcp-wechat-server"]
}
}
}Prompts to try
Example prompts for using the WeChat MCP tools through an AI client to manage messages and login.
- "Generate a WeChat login QR code so I can sign in"
- "Check if my WeChat QR code has been scanned and confirm login status"
- "Get any new WeChat messages I have received in the last 5 minutes"
- "Send a typing indicator to the WeChat chat with [contact name], then send them the message: 'I will get back to you shortly'"
- "Monitor WeChat for new messages and summarize them for me"Troubleshooting WeChat Robot
'bunx' command not found
Install Bun from https://bun.sh using 'curl -fsSL https://bun.sh/install | bash', then restart your terminal. Verify with 'bun --version'. If Bun is installed but bunx is still not found, add ~/.bun/bin to your PATH.
QR code login times out or check_qrcode_status returns not-confirmed
WeChat QR codes expire after approximately 30 seconds. Call login_qrcode again to generate a fresh code and scan it quickly with your WeChat mobile app. Ensure your phone has an active internet connection.
Messages are not received or get_messages returns empty
Verify you are logged in by checking that credentials exist in ~/.mcp-wechat-server/. If the session has expired, call login_qrcode and re-authenticate. WeChat Web sessions can be invalidated by logging into WeChat Web from another location.
Frequently Asked Questions about WeChat Robot
What is WeChat Robot?
WeChat Robot is a Model Context Protocol (MCP) server that wechat robot server based on the model context protocol that enables ai agents to send and receive messages and manage typing status. it provides tools for qr code login, long-polling message retrieval, and persistent state management across variou It connects AI assistants to external tools and data sources through a standardized interface.
How do I install WeChat Robot?
Follow the installation instructions on the WeChat Robot GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.
Which AI clients work with WeChat Robot?
WeChat Robot works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.
Is WeChat Robot free to use?
Yes, WeChat Robot is open source and available under the MIT License license. You can use it freely in both personal and commercial projects.
WeChat Robot Alternatives — Similar Communication Servers
Looking for alternatives to WeChat Robot? 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 Robot 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 Robot?
Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.