Skip to content
MCP server

Wechat Writer MCP

MCP server that formats markdown for WeChat Official Accounts and saves drafts, never

Runs locallyStatus and history
Install
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-mcp

Add 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 → 开发 → 基本配置)Required
  • WECHAT_APP_SECRET微信公众号 AppSecret(mp.weixin.qq.com → 开发 → 基本配置)Required
  • WECHAT_COVERS_DIR封面图片目录,默认 ~/Pictures/wechat-covers
  • WECHAT_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.

How AIPoweredBot checks servers