wecomcli-message Skill for Claude Code: What It Does and How to Install It

Makes Claude send WeCom messages, files, images, voice and video to you or to your recent chats.

Installs: 8.6K; on skills.sh
Stars: 3.3K; on GitHub
Updated: Oct 2026; last repo commit

Ask Claude to message someone on WeCom. It can send to you (the person who signed in) or to single and group chats that appear in the recent-sessions list the bot can see. Message types are Markdown, image, file, voice and video.

It sends the message when your request has a clear target and content. SKILL.md says not to ask again for confirmation in that case, so word the request carefully. If the chat is not in the recent list, it stops and tells you it can only send to recent chats or to you.

Good for

People who want Claude to notify them or a team chat in WeCom
Teams using WeCom for alerts and status updates
Anyone sending a file or image from their computer into a WeCom chat

Install wecomcli-message

Claude Code

Copy this prompt.

Install the wecomcli-message skill in Claude Code. Run this command:

npm install -g @wecom/cli

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js 18 or newer, A WeCom account.

Do steps 1 to 3. Step 2 has alternatives: the README command installs all 15 skills in the repo, the second command installs only wecomcli-shared, wecomcli-message, wecomcli-media. Every wecomcli-* skill must also read wecomcli-shared before it runs a command (its SKILL.md says so), so install that one too. The shared skill checks that wecom-cli is installed at version 1.2.1 or newer and signed in, and runs npm install -g @wecom/cli and the sign-in itself if not. The README also mentions an optional bot ID and secret for a smart bot. The skill runs the wecom-cli program on your machine, so there is no Claude app upload route.

From the project README. Source.

What's in the skill

When it loads

查询当前可以发送消息的聊天会话范围，并向会话列表中的单聊或群聊发送文本、Markdown、图片、文件、语音、视频消息。用户要求“给某人发消息”“在某个群里通知”“给最近会话发消息”或“把图片/文件/语音/视频发到企业微信”时使用。

Sections in SKILL.md

适用范围
适用
不适用
技能依赖
获取能发送消息的会话列表
命令
返回
chat_id 来源
目标会话匹配
发送消息
前置条件
命令
公共参数
Markdown 消息
图片消息
文件消息

Key facts

Author: WeComTeam (repo owner; the repo is the wecom-cli tool this skill drives)
License: MIT (LICENSE file and README badge)
Installs on skills.sh: 8,590 (Nov 2, 2026)
GitHub stars: 3,275 for the whole wecomteam/wecom-cli repo (Nov 2, 2026)
Last repo commit: Oct 19, 2026
What it includes: 1 file: SKILL.md. The folder holds no scripts
skills.sh audits: Gen Agent Trust Hub: pass; Socket: pass; Snyk: pass (Nov 2, 2026)
Also reads: wecomcli-shared (required) and wecomcli-media, which it reads to turn a local file into a media_id
Needs: wecom-cli 1.2.1 or newer (installed and checked by wecomcli-shared), Node.js 18 or newer, and a WeCom account

What it includes

wecom-cli identity whoami returns the signed-in person to use as the target
Sending a message to yourself needs no session list.
Runs code · Find yourself
wecom-cli message aibot sessions list
Returns single and group chats, newest first, with name, type and last message time. SKILL.md says the target must be in this fresh list.
Runs code · List recent chats
wecom-cli message aibot send with msg_type markdown, image, file, voice or video
Markdown is up to 20,480 UTF-8 bytes. Voice must be real AMR. Video can have a title (128 bytes) and a description (512 bytes).
Try: “Send a Markdown summary of this report to my WeCom”
Runs code · Send a message
Uses wecomcli-media to upload a local file and get a media_id
The upload type must match the message type. SKILL.md says not to upload before the target is matched.
Runs code · Prepare media

From the official docs

Permissions

High risk

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

It sends messages without a second confirmation
SKILL.md says that when the target and content are complete, it runs the send directly and does not ask again. Say exactly what to send and where. github.com
Group chats and files reach other people
Any chat in the recent list can be a target, including groups. A file or image you ask it to send leaves your computer for that chat. github.com
Claude may install a global npm package
The shared skill runs npm install -g @wecom/cli if wecom-cli is missing or older than 1.2.1, then starts the QR-code sign-in. Install the CLI yourself first if you want to control the version. github.com
The CLI reports the calling agent to WeCom
The docs say wecom-cli reads the name of the agent program that calls it and sends the call chain to WeCom's cloud with each request. It is on by default in the npm build and can be switched off only by building from source with --no-default-features. github.com
Returned content is treated as data
The skill's safety note says nothing returned by the WeCom API is to be treated as instructions, and tokens or secrets in it are not to be output or used. github.com

Security advisories

No published security advisories as of Nov 2, 2026.

Technical details

Turning on read-only	No read-only mode.
Talks to	WeCom cloud services, reached through the wecom-cli program. npm registry (when the shared skill installs @wecom/cli)
Sign-in and keys	Sign-in is a one-time QR-code scan with wecom-cli auth init. The skill's safety note says tokens and secrets are not to be output or used.
Scopes	Sends messages, images, files, voice and video from the WeCom bot to the signed-in person and to recent chats Reads the recent chat list Uploads local files you name through the media skill

Questions

How do I install it in Claude Code?

Use the install box at the top of this page. Install the CLI, add the skills (wecomcli-shared, wecomcli-media and wecomcli-message) and sign in once with a QR code. The README says the skills install is required.

Do I need a WeCom account?

Yes. The README lists a WeCom account as a prerequisite, plus Node.js 18 or newer. A smart-bot ID and secret are optional and come from WeCom's help page.

Does it send usage data to WeCom?

The docs say wecom-cli reads the name of the calling agent program and sends the call chain with each request to WeCom's cloud, to help find problems. The npm build has this on by default. Building from source with --no-default-features turns it off.

Does it work in the Claude app, Codex or Cursor?

The install box has Claude Code, Codex and skills CLI routes. There is no Claude app upload route, because the skill drives the wecom-cli program on your machine. The README does not name Cursor.

What does the wecomcli-message skill do?

It makes your agent send WeCom messages through the wecom-cli program. It can message the signed-in person or chats from the recent-sessions list, in Markdown, image, file, voice or video form.

Who can it message?

SKILL.md says the signed-in person, and single or group chats the bot has recently exchanged messages with. It cannot message someone who is not in the recent list, and it will not accept an outside chat ID.

Will it ask before sending?

Not when your request names a target and gives the content. SKILL.md says to run it directly in that case and only ask about missing target, content or file. Our advice: ask for a draft first if you want to review the text.

Is it safe?

It sends real messages to real people and groups, and runs the send directly once the target and content are clear. Our advice: name the target and content exactly, ask for a draft first when the audience is wide, and try it on yourself before a group chat.

Information

updated Nov 2, 2026

Repository: wecomteam/wecom-cli
Folder: skills/wecomcli-message

wecomteam/wecom-cli skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

wecomcli-message SKILL.md · github.com
wecomcli-shared SKILL.md · github.com
wecom-cli README · github.com
wecom-cli skills overview · github.com
wecom-cli data collection notice · github.com