← Back to WeChat MCP Enhanced

Install WeChat MCP Enhanced

Pick your client, copy the command, done.

Manual setup required. The maintainer's config contains paths only you know - edit the placeholders below before adding it to Claude Code.
1

Prepare the server locally

Run this once before adding it to Claude Code.

git clone https://github.com/mikewangmax/wechat-mcp-enhanced.git
cd wechat-mcp-enhanced
pip install -r requirements.txt
2

Register it in Claude Code

claude mcp add -e "WECHAT_CONFIG_PATH=${WECHAT_CONFIG_PATH}" wechat-mcp-enhanced -- python /path/to/wechat-mcp-enhanced/src/server.py

Replace any placeholder paths in the command with the real path on your machine.

Required:WECHAT_CONFIG_PATH

Environment Variables

Set these before running WeChat MCP Enhanced.

VariableDescriptionRequired
WECHAT_CONFIG_PATHPath to the settings.py configuration fileYes

Available Tools (8)

Once configured, WeChat MCP Enhanced gives your AI agent access to:

send_fileSends a file to a specified WeChat friend or group chat.
target_userfile_path
receive_fileReceives a file from a message ID and saves it to a path.
message_idsave_path
send_voiceSends a voice message to a specified WeChat friend or group chat.
target_useraudio_path
receive_voiceReceives a voice message from a message ID and saves it to a path.
message_idsave_path
convert_audioConverts audio files to the required format for WeChat.
input_pathoutput_format
start_voice_callInitiates a voice call with a specified WeChat user.
target_user
end_voice_callEnds an active voice call using the call ID.
call_id
get_call_statusRetrieves the current status of a voice call.
call_id

Try It Out

After setup, try these prompts with your AI agent:

Send the file located at C:\documents\report.pdf to my contact 'John Doe'.
Convert the audio file at C:\recordings\note.wav to the format required for WeChat.
Start a voice call with 'Alice' and check the status of the call.
Download the latest voice message from 'Group Chat A' and save it to my desktop.
Prerequisites & system requirements
  • An MCP-compatible client (Claude Code, Cursor, Windsurf, Claude Desktop, or Codex)
  • Python 3.8+ with pip installed
  • WECHAT_CONFIG_PATH — Path to the settings.py configuration file
Conare · memory for coding agents

Keep this setup from going cold

Save the docs, env vars, and workflow around WeChat MCP Enhanced in Conare so Claude Code, Codex, and Cursor remember it next time.

Remember this setup$npx conare@latest