Wecom MCP Server

Model Context Protocol (MCP) server for WeCom Bot message sending

Local serverstdioGo

What is the Wecom MCP server?

Wecom MCP server is a locally run integration for AI assistants that speak the Model Context Protocol. Model Context Protocol (MCP) server for WeCom Bot message sending.

What you get

Configuration can be set via CLI flags, environment variables, or a config file.

  • Text Messages — Send plain text with @mention support (by user ID or mobile number)
  • Markdown Messages — Send Markdown-formatted messages (headings, bold, links, quotes, etc.)
  • Image Messages — Send base64-encoded images (JPG/PNG, up to 2MB)
  • News Messages — Send article list cards (1–8 articles with title, description, URL, cover image)
  • Template Cards — Send text notice and news notice template cards with highlighted content, key-value pairs, links, and click actions
  • File Upload — Upload files to WeCom server (up to 20MB) and get back a media_id

Setting it up

Installation goes through your MCP client rather than a global install: point it at @futuretea/wecom-bot-mcp-server on npm and it is fetched when the client starts. The copy-paste blocks for Claude Desktop, Claude Code and Cursor are further down this page.

What the assistant can call

Once Wecom is connected, these are the calls the assistant has available:

  • content — string
  • mentioned_list — string[]
  • mentioned_mobile_list — string[]
  • base64 — string
  • md5 — string
  • articles — object[]
  • main_title — string
  • main_title_desc — string
  • sub_title — string
  • source — object
  • source.icon_url — string
  • source.desc — string

Configuration and credentials

You will need 3 environment variables: YOUR_KEY, WECOM_MCP_WECOM_BOT_KEY, WECOM_MCP_WECOM_BOT_API_BASE_URL. The server will not start without them, which is usually why the tools fail to appear on a first run. Keep credentials in your client's env block or a secrets manager rather than in a file you might commit.

  • A WeCom bot webhook key (from the webhook URL: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY)

Before you rely on it

  • It runs with your machine's permissions. That is convenient and also the reason to think about what you point it at before you approve a tool call.
  • With 14 tools registered it takes up a noticeable share of the context window; turn it off in projects that never touch Wecom.
  • Missing credentials fail quietly in some clients — if no tools show up, check the environment block first.
  • MCP clients confirm each tool call by default. Leave that on until you have watched what the wecom mcp server does with a few real requests.

Choosing this one

This sits in the cloud and infrastructure group, where several servers overlap in what they claim to do but differ sharply once you actually set them up. Wecom's toolset — content, mentioned_list, mentioned_mobile_list and 11 more — is a fair guide to whether it matches your workflow. It is maintained by futuretea; worth a glance at recent repository activity before you build anything load-bearing on it.

This entry was verified against Wecom's own documentation before publication; SyncDev keeps the directory reviewed rather than auto-generated.

Available tools

ToolWhat it does
contentstring
mentioned_liststring[]
mentioned_mobile_liststring[]
base64string
md5string
articlesobject[]
main_titlestring
main_title_descstring
sub_titlestring
sourceobject
source.icon_urlstring
source.descstring
emphasis_contentobject
emphasis_content.titlestring

How to install the Wecom MCP server

{
  "mcpServers": {
    "wecom-bot-1": {
      "command": "npx",
      "args": ["-y", "@futuretea/wecom-bot-mcp-server"],
      "env": {
        "YOUR_KEY": "your-value",
        "WECOM_MCP_WECOM_BOT_KEY": "your-value",
        "WECOM_MCP_WECOM_BOT_API_BASE_URL": "your-value"
      }
    }
  }
}

Add to claude_desktop_config.json, then restart Claude Desktop.

Configuration

  • A WeCom bot webhook key (from the webhook URL: https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=YOUR_KEY)
VariableDescriptionRequired
YOUR_KEYCredential the server authenticates with.Yes
WECOM_MCP_WECOM_BOT_KEYCredential the server authenticates with.Yes
WECOM_MCP_WECOM_BOT_API_BASE_URLEndpoint or connection string the server talks to.Yes

Example prompts to try

  • Use Wecom to content.
  • Use Wecom to mentioned list.
  • Use Wecom to mentioned mobile list.

Frequently asked questions

It connects Wecom to MCP-compatible AI assistants such as Claude and Cursor, exposing 14 tools (content, mentioned_list, mentioned_mobile_list, and more) that the assistant can call on your behalf. Instead of copying data back and forth by hand, the assistant works with Wecom directly.