biboyqg/wechat-mcp

中文 |英語

macOS上でアクセシビリティAPIとスクリーンキャプチャを用いてWeChatを自動化するMCPサーバーです。これによりLLMがWeChatチャットとプログラム的にやり取りできます。

特徴

• 📨 任意のチャット(連絡先またはグループ)からの最近のメッセージを取得する
• ✍️ チャット履歴に基づく自動返信送信
• 📷 テキストのみのモーメンツ投稿を公開、オプションで下書き専用モードを選択
• 👥 設定可能なプライバシーを持つWeChat IDを使った連絡先の追加
• 🔍 名前が正確に一致するスマートチャット検索
• 🤖 スマートWeChat自動化用の5つの専門的なClaude Codeサブエージェント

クイックスタート

就任

クロードコードでのセットアップ

Claude Desktopでのセットアップ

コデックスでのセットアップ

macOS 権限

⚠️ 重要:端末にアクセシビリティ権限を付与する:

1. オープン システム設定 →プライバシー&セキュリティ→アクセシビリティ
2. 端末アプリケーション(Terminal.app、iTerm2など)を追加する
3. サーバーを使用する前にWeChatが稼働していることを必ず確認してください

使用法

基本コマンド

利用可能なMCPツール

• fetch_messages_by_chat - チャットからの最近のメッセージを取得
• reply_to_messages_by_chat - チャットに返信を送る

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

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