huohuoer/wechat-cli

Health v2 · maintenance only

Flags: no_releases young

Adoption not part of the score

2035 stars · 1730 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

A command-line tool that queries local WeChat data including chat history, contacts, sessions, and favorites, with on-the-fly SQLCipher decryption that keeps data fully local. It outputs JSON by default and is designed for LLM agent tool-call integration.

Use cases

• query my wechat chat history from the terminal
• search wechat messages for a keyword
• export wechat chat logs to markdown
• get statistics on my most active wechat contacts
• let an AI agent read my wechat messages
• list unread wechat messages and sessions

When to choose

• you want programmatic or LLM-agent access to your local WeChat data
• you need chat analytics like top senders or activity charts
• you want to export conversations to Markdown or text with time filters
• you prefer data staying fully on your machine

When to avoid

• you need a graphical WeChat backup tool
• you want to send or modify WeChat messages rather than read data
• you need a supported binary for platforms other than macOS arm64 and cannot use pip
• you are not the owner of the WeChat account whose data you query

Facets

cli-tool · maturity active

cli search-engine data-science developer-tools llm-inference messaging-platforms developer-tools privacy large-language-models windows cli python wechat chat-history sqlcipher local-data llm-agent-tools -output data-export command-line macos linux nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="huohuoer/wechat-cli")