WeChat Log MCP

v1.0.0Communicationstable

WeChat Chatlog MCP Server - 直接下载微信聊天媒体文件到本地

wechatlogmcpai-integration
Share:
34
Stars
0
Downloads
0
Weekly
0/5

What is WeChat Log MCP?

WeChat Log MCP is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to wechat chatlog mcp server - 直接下载微信聊天媒体文件到本地

WeChat Chatlog MCP Server - 直接下载微信聊天媒体文件到本地

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

Features

  • WeChat Chatlog MCP Server - 直接下载微信聊天媒体文件到本地

Use Cases

Download WeChat chat media files locally.
Archive and analyze WeChat conversations.
Extract and process WeChat message history.
LupinLin1

Maintainer

LicenseMIT
Languagejavascript
Versionv1.0.0
UpdatedMay 3, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx wechatlog

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 Log MCP

Wechatlog MCP Server is a Node.js MCP server designed for Claude Code CLI that connects to a locally running Chatlog API service to access WeChat message history and media files. It exposes tools to query chat logs by contact or keyword, list contacts and group chats, and directly download images, voice messages, videos, and files from WeChat conversations to local storage. Teams who archive or analyze WeChat data use it to retrieve and process conversation content without manual export steps.

Prerequisites

  • Node.js 16.0.0 or higher installed
  • A running Chatlog API service (default at http://127.0.0.1:5030)
  • Claude Code CLI or another MCP-compatible client
  • A local directory for downloaded media files
1

Clone the repository

Clone the wechatlog-mcp-server repository to your local machine.

git clone https://github.com/LupinLin1/wechatlog-mcp-server.git
cd wechatlog-mcp-server
2

Run the install script

Execute the provided install script or use node install.js to set up the server.

node install.js
3

Configure the environment

Edit the .env file to point at your running Chatlog API and set a default download directory as an absolute path.

CHATLOG_BASE_URL=http://127.0.0.1:5030
DEFAULT_DOWNLOAD_DIR=/Users/username/Downloads/wechat-media
4

Start the MCP server

Launch the server process so it is ready to accept connections from your MCP client.

npm start
5

Register with Claude Code

Add the server to Claude Code's MCP registry so it can invoke the WeChat tools.

claude mcp add chatlog node chatlog-mcp-server.js

WeChat Log MCP Examples

Client configuration

Claude Desktop configuration to connect to the locally running Wechatlog MCP server.

{
  "mcpServers": {
    "wechatlog": {
      "command": "node",
      "args": ["/absolute/path/to/wechatlog-mcp-server/chatlog-mcp-server.js"],
      "env": {
        "CHATLOG_BASE_URL": "http://127.0.0.1:5030",
        "DEFAULT_DOWNLOAD_DIR": "/Users/username/Downloads/wechat-media"
      }
    }
  }
}

Prompts to try

Example prompts for querying WeChat history and downloading media via the server.

- "List all my WeChat contacts."
- "Show me the last 20 messages from contact 'Alice'."
- "Download all images from my conversation with 'ProjectTeam' group from the past week."
- "Get all voice messages from contact 'Bob' and save them locally."

Troubleshooting WeChat Log MCP

Server cannot connect to the Chatlog API

Verify the Chatlog API service is running and that CHATLOG_BASE_URL in .env matches its address and port (default: http://127.0.0.1:5030).

Download fails with permission errors

Ensure DEFAULT_DOWNLOAD_DIR is set to an absolute path that your user account has write access to. Relative paths are not supported.

Claude Code does not list the chatlog tools

Re-run `claude mcp add chatlog node chatlog-mcp-server.js` with the full absolute path to the JS file, then restart the Claude Code session.

Frequently Asked Questions about WeChat Log MCP

What is WeChat Log MCP?

WeChat Log MCP is a Model Context Protocol (MCP) server that wechat chatlog mcp server - 直接下载微信聊天媒体文件到本地 It connects AI assistants to external tools and data sources through a standardized interface.

How do I install WeChat Log MCP?

Follow the installation instructions on the WeChat Log MCP GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with WeChat Log MCP?

WeChat Log MCP works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is WeChat Log MCP free to use?

Yes, WeChat Log MCP is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

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.

Quick Config Preview

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

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

Read the full setup guide →

Ready to use WeChat Log MCP?

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