WeChat Chatlog MCP Server

Overview

WeChat Chatlog MCP Server is a specialized Model Context Protocol (MCP) server that enables AI agents, particularly Claude Code CLI, to interact with WeChat chat logs programmatically. It focuses on querying historical conversations and downloading media attachments (images, videos, files) directly to local storage.

Built to bridge WeChat's local data with modern AI workflows, it allows large language models to analyze, summarize, or process past chats without manual export.

Features

• Advanced Chat Log Querying: Filter messages by time range, sender, keywords, or chat participants.
• Media File Download: Automatically download images, videos, and other attachments from selected chats to your local filesystem.
• MCP Compatibility: Seamless integration with MCP-compatible clients like Claude Code CLI and other AI agents.
• OpenAPI Specification: Includes a chatlog-openapi.yaml for easy API exploration and integration.
• Lightweight & Focused: Optimized for chat history access and media handling rather than live messaging.

Use Cases

• AI-Powered Chat Analysis: Let Claude or other LLMs review old WeChat conversations, extract insights, or generate summaries.
• Media Archiving: Bulk download photos, videos, and documents shared in WeChat groups or private chats.
• Automation Workflows: Integrate WeChat history into custom AI pipelines for research, customer support review, or personal data management.
• Claude Code CLI Enhancement: Extend Claude's capabilities to work directly with your WeChat data for coding assistance or data processing tasks.

Installation & Setup

The project is hosted on GitHub and provides installation instructions in its repository (including INSTALL.md). It is typically set up as an MCP server for use with compatible AI clients.

After installation, configure your AI agent (e.g., Claude Code) to connect to the running MCP server.

Technical Details

• Protocol: Model Context Protocol (MCP)
• Primary Focus: Read-only access to chat logs + media export
• Platform: Cross-platform support (details in repository)
• License: Open source (check repository for exact terms)

For full documentation, tool signatures, and examples, visit the official GitHub repository.

Related Projects

This tool complements broader WeChat MCP solutions that handle live messaging and automation, focusing specifically on historical chatlog access and media handling.