# Wechat Writer MCP

> Wechat Writer MCP is an open-source MCP server for content publishing. MCP server that formats markdown for WeChat Official Accounts and saves drafts, never. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, self-hosted
- **Repository:** https://github.com/datoushiwo/wechat-writer-mcp
- **MCP Registry name:** io.github.datoushiwo/wechat-writer-mcp
- **Categories:** [content publishing](https://ai-powered.com/categories/content-publishing)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [Medium MCP Server and API by Cotlet](https://ai-powered.com/mcp/medium-mcp-server-and-api-by-cotlet): Medium MCP Server and API by Cotlet is a freemium MCP server for content publishing.
- [Qiita MCP Server](https://ai-powered.com/mcp/qiita-mcp-server): Qiita MCP Server is an open-source MCP server for content publishing.
- [Postbeam](https://ai-powered.com/mcp/postbeam): Postbeam is an MCP server for marketing and seo.
- [Note MCP Server](https://ai-powered.com/mcp/note-mcp-server): Note MCP Server is an open-source MCP server for content publishing.
- [Drupal MCP by usefulapi](https://ai-powered.com/mcp/drupal-mcp-by-usefulapi): Drupal MCP by usefulapi is a freemium MCP server for content publishing.

---
Source: https://ai-powered.com/mcp/wechat-writer-mcp
