Wechat Writer MCP
MCP server that formats markdown for WeChat Official Accounts and saves drafts, never
- Pricing
- Open source
- Platforms
- CLI, API, self-hosted
- Runs
- Locally
- Version
- 0.1.1
- Listing updated
- today
Similar MCP servers
About Wechat Writer MCP
Wechat Writer MCP is an open-source MCP server for content publishing. It runs locally on your machine and is started by your AI client.
The README describes a pipeline for technical bloggers: it imports a local markdown file or web page, reshapes it into WeChat-compatible HTML, runs a self-check for originality, and writes the result into the Official Account draft box. Code blocks are adapted for display, hyperlinks are converted to footnotes, header and footer templates are applied, and several title candidates and a summary suggestion are produced.
The server calls only the draft creation endpoint of the WeChat Official Account API. The README states it never calls the publishing or mass-send endpoints, so the author still sends each article manually from the WeChat back office. The originality check compares text only against the user's own past drafts and is explicitly not a substitute for WeChat's official duplicate detection.
Setup requires an Official Account AppID and AppSecret, and the public IP of the machine must be added to the account's IP whitelist. It runs over stdio through npx and is configured in Claude Code, Cursor or Claude Desktop.
Install
Run in a terminal
claude mcp add wechat-writer-mcp --env WECHAT_APP_ID='<WECHAT_APP_ID>' --env WECHAT_APP_SECRET='<WECHAT_APP_SECRET>' -- npx -y wechat-writer-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"wechat-writer-mcp": {
"command": "npx",
"args": [
"-y",
"wechat-writer-mcp"
],
"env": {
"WECHAT_APP_ID": "<WECHAT_APP_ID>",
"WECHAT_APP_SECRET": "<WECHAT_APP_SECRET>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"wechat-writer-mcp": {
"command": "npx",
"args": [
"-y",
"wechat-writer-mcp"
],
"env": {
"WECHAT_APP_ID": "<WECHAT_APP_ID>",
"WECHAT_APP_SECRET": "<WECHAT_APP_SECRET>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"wechat-writer-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"wechat-writer-mcp"
],
"env": {
"WECHAT_APP_ID": "<WECHAT_APP_ID>",
"WECHAT_APP_SECRET": "<WECHAT_APP_SECRET>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"wechat-writer-mcp": {
"command": "npx",
"args": [
"-y",
"wechat-writer-mcp"
],
"env": {
"WECHAT_APP_ID": "<WECHAT_APP_ID>",
"WECHAT_APP_SECRET": "<WECHAT_APP_SECRET>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"wechat-writer-mcp": {
"command": "npx",
"args": [
"-y",
"wechat-writer-mcp"
],
"env": {
"WECHAT_APP_ID": "<WECHAT_APP_ID>",
"WECHAT_APP_SECRET": "<WECHAT_APP_SECRET>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
WECHAT_APP_ID微信公众号 AppID(mp.weixin.qq.com → 开发 → 基本配置)RequiredWECHAT_APP_SECRET微信公众号 AppSecret(mp.weixin.qq.com → 开发 → 基本配置)RequiredWECHAT_COVERS_DIR封面图片目录,默认 ~/Pictures/wechat-coversWECHAT_DEFAULT_AUTHOR草稿默认作者名WECHAT_API_TIMEOUT微信 API 超时毫秒数,默认 15000
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- import_source
- Imports raw content from a local markdown file or web URL.
- transform_for_wechat
- Formats markdown for WeChat and suggests titles and a summary.
- estimate_originality
- Scores originality against the user's own historical drafts.
- save_to_wechat_draft
- Saves a title and HTML content to the WeChat draft box.
What it does
- Markdown import
- Reads a local markdown file or a web URL and extracts the raw text with title and word-count metadata.
- WeChat formatting
- Converts content to WeChat-ready HTML with code block handling, footnoted links and optional header and footer templates.
- Title suggestions
- Proposes three title candidates and a summary suggestion for each transformed article.
- Originality self-check
- Scores text against the user's own earlier drafts; it does not replace WeChat's official duplicate check.
- Draft-only saving
- Saves articles to the WeChat draft box via the draft API and never submits them for publication or mass sending.
- Configurable covers and author
- Picks cover images from a folder, generates placeholders when none exist, and sets a default author name.
Good for
- Turning a markdown blog post into a formatted WeChat Official Account article
- Drafting several title options before choosing one for an article
- Checking a new article against earlier drafts for repeated paragraphs
- Saving finished posts to the draft box for manual review and sending
Pricing
Open source
MIT-licensed and free to run locally; no paid plan is mentioned.
Wechat Writer MCP FAQ
Does it publish articles automatically?
No. The README says it only calls the draft/add endpoint and never calls freepublish/submit or mass/send; the user sends drafts manually in the back office.
What credentials does it need?
The required environment variables are WECHAT_APP_ID and WECHAT_APP_SECRET, taken from the Official Account's development basic settings. The README also requires adding your IP to the account's IP whitelist.
Does the originality check replace WeChat's duplicate detection?
No. The README states that estimate_originality only compares against your own historical drafts and cannot replace WeChat's official duplicate check.
How is it installed?
It can be run directly with npx wechat-writer-mcp, or installed locally by cloning the repository and running npm install and npm run build.
Is Wechat Writer MCP free?
Yes. Wechat Writer MCP is open source, so you can use and self-host it for free.
How do I add Wechat Writer MCP to Claude Code?
Run this command in your terminal: claude mcp add wechat-writer-mcp --env WECHAT_APP_ID='<WECHAT_APP_ID>' --env WECHAT_APP_SECRET='<WECHAT_APP_SECRET>' -- npx -y wechat-writer-mcp
What are the best alternatives to Wechat Writer MCP?
The closest alternatives to Wechat Writer MCP are Medium MCP Server and API by Cotlet, Qiita MCP Server, Postbeam, Note MCP Server and Drupal MCP by usefulapi.
Where this comes from
- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.