biboyqg avatar

WeChat

biboyqg/wechat-mcp

Connects Claude to WeChat on macOS through the Accessibility API and screen capture, letting you fetch recent messages from any chat, send automated replies, publish Moments posts, and add contacts by WeChat ID. You'd reach for this when building WeChat automation workflows or having Claude manage your WeChat interactions. Includes five specialized sub-agents for tasks like chat summarization, auto-replies, and message search. Requires macOS with Accessibility permissions and a running WeChat app, making it ideal for developers who want programmatic WeChat control without official API access.

GitHub stars
191
tools
4
last updated
Mar 9, 2026

Tools

4 tools

Public tool metadata for what this MCP can expose to an agent.

fetch_messages_by_chatGet recent messages from a chat.

Get recent messages from a chat.

No parameter schema in public metadata yet.

reply_to_messages_by_chatSend a reply to a chat.

Send a reply to a chat.

No parameter schema in public metadata yet.

add_contact_by_wechat_idAdd a new contact using a WeChat ID and send a friend request.

Add a new contact using a WeChat ID and send a friend request.

No parameter schema in public metadata yet.

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

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

No parameter schema in public metadata yet.

Sponsors

Readme

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

View the full README on GitHub

Details

Repository
github.com/biboyqg/wechat-mcp