Skip to main content
Glama
BiboyQG

WeChat MCP Server

by BiboyQG
OverviewSchemaRelated ServersScoreDiscussions
Python
Local

WeChat MCP Server

Python 3.12+ PyPI version License: MIT

δΈ­ζ–‡ | English

An MCP server that automates WeChat on macOS using the Accessibility API and screen capture. It enables LLMs to interact with WeChat chats programmatically.

Features

  • πŸ“¨ Fetch recent messages from any chat (contact or group)

  • ✍️ Send automated replies based on chat history

  • πŸ“· Publish text-only Moments posts, with optional draft-only mode

  • πŸ‘₯ Add contacts using WeChat ID with configurable privacy

  • πŸ” Smart chat search with exact name matching

  • πŸ€– 5 specialized Claude Code sub-agents for smart WeChat automation

Quick Start

Installation

pip install wechat-mcp-server

Setup with Claude Code

# If installed via pip claude mcp add --transport stdio wechat-mcp -- wechat-mcp # If using uv for development claude mcp add --transport stdio wechat-mcp -- uv --directory $(pwd) run wechat-mcp
// If installed via pip { "mcpServers": { "wechat-mcp": { "type": "stdio", "command": "wechat-mcp" } } } // If using uv for development { "mcpServers": { "wechat-mcp": { "type": "stdio", "command": "uv", "args": [ "--directory", "{path/to/wechat-mcp}", "run", "wechat-mcp" ], } } }
# If installed via pip codex mcp add wechat-mcp -- wechat-mcp # If using uv for development codex mcp add wechat-mcp -- uv --directory $(pwd) run wechat-mcp

macOS Permissions

⚠️ Important: Grant Accessibility permissions to your terminal:

  1. Open System Settings β†’ Privacy & Security β†’ Accessibility

  2. Add your terminal application (Terminal.app, iTerm2, etc.)

  3. Ensure WeChat is running before using the server

Usage

Basic Commands

# Run with default stdio transport wechat-mcp --transport stdio # Run with HTTP transport wechat-mcp --transport streamable-http # Run with SSE transport wechat-mcp --transport sse

Available MCP Tools

  • fetch_messages_by_chat - Get recent messages from a chat

  • reply_to_messages_by_chat - Send a reply to a chat

  • add_contact_by_wechat_id - Add a new contact using a WeChat ID and send a friend request

  • publish_moment_without_media - Publish a text-only Moments post (no photos or videos); optionally only prepare a draft without posting via publish=False

See detailed API documentation for full tool specifications.

Claude Code Sub-Agents

This project includes 5 intelligent sub-agents designed specifically for WeChat automation. They enable natural language control of WeChat through Claude Code.

Available Sub-Agents

  1. Chat-summarizer - Summarize chat history and extract key information

  2. Auto-replier - Auto-generate and send appropriate replies

  3. Message-searcher - Search chat history for specific content

  4. Multi-chat-checker - Monitor multiple chats and prioritize messages

  5. Chat-insights - Analyze relationship dynamics and communication patterns

πŸ“– View complete sub-agents guide

Development

Local Setup with uv

# Install uv curl -LsSf https://astral.sh/uv/install.sh | sh # Clone and setup git clone https://github.com/yourusername/WeChat-MCP.git cd WeChat-MCP uv sync # Run locally uv run wechat-mcp --transport stdio

Documentation

Requirements

  • macOS (uses Accessibility API)

  • WeChat for Mac installed and running

  • Python 3.12+

  • Accessibility permissions for terminal

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details

This server cannot be installed

-
security - not tested
A
license - permissive license
-
quality - not tested

How are these scores calculated?

Resources

Appeared in Searches

New MCP Servers

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/BiboyQG/WeChat-MCP'

If you have feedback or need assistance with the MCP directory API, please join our Discord server