MCP Directory

How to add WeCom Group Robot (mcp-wecombot-server) to Windsurf

Send text, markdown, image, news, and template-card messages to a WeCom (WeChat Work) group robot. Paste the config into ~/.codeium/windsurf/mcp_config.json and restart Windsurf.

Last updated June 14, 2026 · 38★ · stdio · apikey

Windsurf config for WeCom Group Robot (mcp-wecombot-server)

npx -y @smithery/cli install @gotoolkits/mcp-wecombot-server --client claude-desktop
{
  "mcpServers": {
    "wecom-group-robot-mcp-wecombot-server": {
      "command": "mcp-wecombot-server",
      "args": [],
      "env": {
        "WECOM_BOT_WEBHOOK_KEY": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxx"
      }
    }
  }
}

Setup steps

  1. 1Open Windsurf → Cascade → the hammer/MCP icon → Configure (or edit ~/.codeium/windsurf/mcp_config.json).
  2. 2Paste the WeCom Group Robot (mcp-wecombot-server) config below.
  3. 3Fill in placeholder secrets, then save.
  4. 4Click Refresh in the MCP panel.
  5. 5WeCom Group Robot (mcp-wecombot-server)'s tools become available to Cascade.

Before you start

  • A WeCom (Enterprise WeChat / 企业微信) group with a configured group robot
  • The group robot webhook key (WECOM_BOT_WEBHOOK_KEY), taken from the robot's webhook URL `key` parameter
  • The mcp-wecombot-server binary installed (via Smithery, prebuilt release, or built from source with `make build`)

What WeCom Group Robot (mcp-wecombot-server) can do in Windsurf

send_text

Send a text message to a WeCom group.

send_markdown

Send a markdown message to a WeCom group.

send_image

Send an image message to a WeCom group.

send_news

Send a news (graphic) message to a WeCom group; a news item includes title, description, url, and picurl.

send_template_card

Send a template card message to a WeCom group.

upload_file

Upload a file to WeCom.

Security

Authentication is via the WeCom group robot webhook key, passed as the WECOM_BOT_WEBHOOK_KEY environment variable. Anyone holding this key can post messages to the target WeCom group, so treat it as a secret and avoid committing it to source control. The key corresponds to the `key` parameter of the WeCom webhook URL (https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=...).

WeCom Group Robot (mcp-wecombot-server) + Windsurf FAQ

Where is the Windsurf config file?

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Paste the WeCom Group Robot (mcp-wecombot-server) config there under the "mcpServers" key and restart the client.

Is WeCom Group Robot (mcp-wecombot-server) safe to use with Windsurf?

Authentication is via the WeCom group robot webhook key, passed as the WECOM_BOT_WEBHOOK_KEY environment variable. Anyone holding this key can post messages to the target WeCom group, so treat it as a secret and avoid committing it to source control. The key corresponds to the `key` parameter of the WeCom webhook URL (https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=...).

What is WECOM_BOT_WEBHOOK_KEY and where do I get it?

It is the WeCom group robot's webhook key. In the robot's webhook URL (https://qyapi.weixin.qq.com/cgi-bin/webhook/send?key=693axxx6-7aoc-4bc4-97a0-0ec2sifa5aaa), the value after `key=` is your WECOM_BOT_WEBHOOK_KEY. See the WeCom robot configuration guide at https://developer.work.weixin.qq.com/document/path/91770.

How do I install it?

You can install automatically for Claude Desktop via Smithery (`npx -y @smithery/cli install @gotoolkits/mcp-wecombot-server --client claude-desktop`), or manually by cloning the repo and running `make build`, then symlinking the produced binary into your PATH (or downloading a precompiled release binary).

What kinds of messages can it send?

Text, markdown, images, news (graphic) messages with title/description/url/picurl, and template cards. It can also upload files to WeCom.

View repo Full WeCom Group Robot (mcp-wecombot-server) page