wecom-unified

Original：🇨🇳 Chinese

Translated

All-in-one WeCom CLI Suite covering 6 core business domains: Contacts, Messages, Documents (including three types: Document, Smart Sheet, Smart Document (formerly Smart Homepage)), Schedules, Meetings, and Tasks. It supports searching contacts by name/alias, sending and receiving messages (text/image/file/voice/video), creating/reading/editing documents in Markdown format, managing Smart Sheet structures and records, creating Smart Documents and exporting their content as Markdown, creating/modifying/canceling schedules and checking availability, booking/managing meetings, and creating/tracking/assigning tasks. This skill should be triggered even if users do not explicitly mention 'WeCom' as long as scenarios involving messages, schedules, tasks, etc., are involved.

3installs

Sourcewecomteam/wecom-unified

Added on2026-04-22

NPX Install

npx skill4agent add wecomteam/wecom-unified wecom-unified

SKILL.md Content (Chinese)

View Translation Comparison →

WeCom Unified Suite

All-in-one WeCom CLI (

wecom-cli

) suite, interacting with the WeCom system via command-line tools, covering 6 core business domains: Contacts, Messages, Documents (including 3 types: Document, Smart Sheet, Smart Document), Schedules, Meetings, and Tasks.

⚠️ Pre-check — Must be executed before using any commands

Step 1: Check if CLI is installed

bash

wecom-cli --version

If the command does not exist or throws an error, execute the installation:

bash

npm install -g @wecom/cli

Step 2: Check if credentials are configured

bash

wecom-cli auth show --auth-status

Output
```
authorized
```
→ Configured, you can proceed
Output
```
unauthorized
```
→ Not configured, need to execute Step 3

Step 3: Configure credentials (only execute if unauthorized)

bash

wecom-cli init --noninteractive

⚠️ This command will output an authorization link and QR code, and block waiting for the user to scan the code to complete verification. The command will exit automatically after successful authorization, and only needs to be executed once.

Business Domain Overview

👤 Contacts (contact)

Get visible member list, search matches by name/alias, query userid.

→ See details in references/wecom-contact.md

💬 Messages (msg)

Query conversation list, pull message records (text/image/file/voice/video), get multimedia files, send text messages.

→ See details in references/wecom-msg.md

📄 Documents, Smart Sheets & Smart Documents (doc)

Create/read/edit documents (in Markdown format), manage Smart Sheet sub-tables, fields/columns, add/delete/update/query records, create Smart Documents (Smart Homepage) and export content. Support locating documents via docid or URL, automatically identify document types (Document/Smart Sheet/Smart Document) and route to the correct interface.

→ See details in references/wecom-doc.md

📅 Schedules (schedule)

Query schedule list and details, create/modify/cancel schedules, add/remove participants, check availability status of multiple members and analyze common free time slots.

→ See details in references/wecom-schedule.md

🎥 Meetings (meeting)

Create scheduled meetings, query meeting list and details, cancel meetings, update invited members.

→ See details in references/wecom-meeting.md

✅ Tasks (todo)

Query task list and details, create/update/delete tasks, change user processing status (accept/reject/complete), assign tasks.

→ See details in references/wecom-todo.md

Common Concepts and Rules

General call format, return format, error handling, contact query methods, and time format specifications shared by all business domains.

→ See details in references/wecom-shared.md

Quick Examples

Query contact members

bash

wecom-cli contact get_userlist '{}'

View recent conversation list

bash

wecom-cli msg get_msg_chat_list '{"begin_time": "2026-04-08 00:00:00", "end_time": "2026-04-15 23:59:59"}'

Send text message

bash

wecom-cli msg send_message '{"chat_type": 1, "chatid": "zhangsan", "msgtype": "text", "text": {"content": "hello"}}'

Create document

bash

wecom-cli doc create_doc '{"doc_type": 3, "doc_name": "项目周报"}'

Read document content (Markdown format)

bash

wecom-cli doc get_doc_content '{"docid": "DOCID", "type": 2}'

Create Smart Document (Smart Homepage)

⚠️ Special Syntax: This command must use
+smartpage_create
(with
+
prefix), the plus sign cannot be omitted; this
+
only applies to this command, do not generalize to other
doc
sub-commands.

bash

wecom-cli doc +smartpage_create '{"title": "项目概览", "pages": [{"page_title": "需求文档", "content_type": 1, "page_filepath": "/path/to/requirements.md"}]}'

Export Smart Document content

bash

wecom-cli doc smartpage_export_task '{"docid": "DOCID", "content_type": 1}'

Query today's schedules

bash

wecom-cli schedule get_schedule_list_by_range '{"start_time": "2026-04-15 00:00:00", "end_time": "2026-04-15 23:59:59"}'

Create scheduled meeting

bash

wecom-cli meeting create_meeting '{"title": "周例会", "meeting_start_datetime": "2026-04-16 15:00", "meeting_duration": 3600}'

View task list

bash

wecom-cli todo get_todo_list '{}'

Create task

bash

wecom-cli todo create_todo '{"content": "完成Q2规划文档", "remind_time": "2026-04-20 09:00:00"}'

wecom-unified

NPX Install

Tags

SKILL.md Content (Chinese)

WeCom Unified Suite

⚠️ Pre-check — Must be executed before using any commands

Step 1: Check if CLI is installed

Step 2: Check if credentials are configured

Step 3: Configure credentials (only execute if unauthorized)

Business Domain Overview

👤 Contacts (contact)

💬 Messages (msg)

📄 Documents, Smart Sheets & Smart Documents (doc)

📅 Schedules (schedule)

🎥 Meetings (meeting)

✅ Tasks (todo)

Common Concepts and Rules

Quick Examples

Query contact members

View recent conversation list

Send text message

Create document

Read document content (Markdown format)

Create Smart Document (Smart Homepage)

Export Smart Document content

Query today's schedules

Create scheduled meeting

View task list

Create task