MCPgee
MCPgee
MCPgeeMCPgee

WeChat

v1.0.0•Communication•stable

Model Context Protocol for WeChat

wechatmcpai-integration
Share:
99
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is WeChat?

WeChat is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol for wechat

Model Context Protocol for WeChat

This server falls under the Communication category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • Model Context Protocol for WeChat

Use Cases

Access WeChat services and messaging through MCP protocol. Send and receive WeChat communications.
panxingfeng

Maintainer

LicenseMIT
Languagepython
Versionv1.0.0
UpdatedMay 22, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx wechat

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use WeChat

MCP Server WeChat bridges AI assistants directly to WeChat, China's dominant messaging platform, enabling programmatic chat history retrieval and automated message sending to individual contacts or multiple friends simultaneously. It is built as a Python package installable via pip, and exposes tools for reading past conversations by date and dispatching single or bulk messages. Developers and power users who need AI-assisted WeChat communication or conversation analysis will find this server especially useful.

Prerequisites

  • Python 3.8+ installed
  • pip package manager available
  • WeChat desktop client installed and logged in on the same machine
  • A folder path where WeChat stores its local chat history (the --folder-path argument)
  • An MCP-compatible client such as Claude Desktop
1

Install the mcp_server_wechat package

Install the server via pip. This provides both the stdio and SSE transport variants.

pip install mcp_server_wechat
2

Locate your WeChat history folder

Find the directory where WeChat stores local chat data on your machine. On Windows this is typically inside %AppData%\Tencent\WeChat. You will pass this path as --folder-path when running the server.

3

Configure Claude Desktop with the stdio transport

Add the WeChat MCP server to your Claude Desktop config file using the stdio transport. Replace the folder-path value with your actual WeChat history directory.

4

Alternatively, run the SSE server for remote access

For SSE-based integration, start the server manually with your folder path. Then configure your MCP client to connect to the SSE endpoint URL.

python -m mcp_server_wechat_sse --folder-path=C:\Users\YourName\AppData\Roaming\Tencent\WeChat
5

Restart your MCP client and verify tools are available

Restart Claude Desktop. The four WeChat tools — wechat_get_chat_history, wechat_send_message, wechat_send_multiple_messages, and wechat_send_to_multiple_friends — should now appear in the tool list.

WeChat Examples

Client configuration

Claude Desktop stdio config pointing to the installed mcp_server_wechat module with the WeChat history folder.

{
  "mcpServers": {
    "wechat": {
      "command": "python",
      "args": ["-m", "mcp_server_wechat", "--folder-path=C:\\Users\\YourName\\Documents\\WeChat"]
    }
  }
}

Prompts to try

Example prompts demonstrating WeChat history retrieval and messaging capabilities.

- "Get my chat history with Zhang Wei from 25/6/1 and summarize the key points"
- "Send a message to Li Ming saying 'Meeting rescheduled to 3pm tomorrow'"
- "Send the message 'Happy birthday!' to contacts Wang Fang, Chen Lei, and Liu Yang"
- "Retrieve my conversation with the 'Project Alpha' group from last Monday and list any action items"

Troubleshooting WeChat

Chat history tool returns no results or empty data

Verify the --folder-path argument points to the correct WeChat local data directory. The target_date parameter expects YY/M/D format (e.g., 25/6/1 for June 1, 2025). Ensure WeChat is installed and has synced recent messages.

Messages fail to send — WeChat is not responding

The send tools interact with the WeChat desktop client, which must be running and logged in on the same machine. Ensure WeChat desktop is open and your account is authenticated before attempting to send messages via MCP.

pip install fails or import errors on startup

Try upgrading the package with 'pip install --upgrade mcp_server_wechat'. If errors persist, check your Python version (3.8+ required) and ensure pip is up to date with 'pip install --upgrade pip'.

Frequently Asked Questions about WeChat

What is WeChat?

WeChat is a Model Context Protocol (MCP) server that model context protocol for wechat 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. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

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.1k

Enables 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.3k

Enhanced 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.9k

A 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.7k

Connects 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.1k

Enables 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.

CommunicationBrowse All Servers

Quick Config Preview

{ "mcpServers": { "wechat": { "command": "npx", "args": ["-y", "wechat"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

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.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides