How do I install the Dingtalk CLI skill?

Run npx skillmds@latest add gabrielmoreira/dingtalk-cli in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Dingtalk CLI safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Dingtalk CLI?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Dingtalk CLI free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Dingtalk CLI?

gabrielmoreira (@gabrielmoreira) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Dingtalk CLI by gabrielmoreira — Agent Skill

Name: Dingtalk CLI
Rating: 4.2 (5 reviews)
Author: gabrielmoreira

Dingtalk CLI

Use when the user wants to interact with DingTalk in any way — including but not limited to: reading, querying, searching, sending, replying to, forwarding, or recalling DingTalk chat messages and chat history; managing group chats and conversations; sending DING alerts; querying contacts, org structure, AI search, or coworkers; reading, searching, creating, or editing DingTalk docs, drive files, sheets, AI tables, wiki, mail, calendar events, meeting rooms, AI meeting minutes, attendance, OA approvals, todos, reports/logs, live sessions, AI apps, permissions, or open-platform docs.

gabrielmoreira Updated Sep 9, 2026 17 repo stars

File contents

DingTalk CLI Skill Index

Before doing anything, you MUST load the dws skill first. It contains the full product reference, command syntax, intent routing decision tree, dangerous operation rules, and error handling guide. Do not proceed without reading it.

read_skills(skill_names=["dws"])

Product Overview

Product	Use for	CLI entry
`aiapp`	AI apps: create, query, update	`dws aiapp`
`aisearch`	AI search: find people by name, employee number, phone, department, responsibility, reporting lines	`dws aisearch`
`aitable`	AI tables: bases, tables, fields, records, views, charts, dashboards, import/export	`dws aitable`
`attendance`	Attendance: punch records, shift schedules, statistics	`dws attendance`
`calendar`	Calendar: events, attendees, meeting rooms, availability	`dws calendar`
`chat`	Conversations, group chats, bot messaging, single chat, Webhook, message history, direct/group message list, sender filters, unread conversations, keyword and advanced message search, read/send status, send/reply/forward/recall	`dws chat`
`contact`	Contacts: user lookup, department structure	`dws contact`
`devdoc`	DingTalk open platform developer documentation search	`dws devdoc`
`ding`	DING alerts: send/recall (in-app / SMS / phone)	`dws ding`
`doc`	DingTalk docs: search, read, write, block edit, comments, copy/move	`dws doc`
`drive`	Cloud drive: file list, upload, download, folders	`dws drive`
`live`	Live sessions: list and info	`dws live`
`mail`	Mail: search, view, send	`dws mail`
`minutes`	AI meeting minutes: list, summary, transcript, todos, mindmap	`dws minutes`
`oa`	OA approvals: pending, submitted, approve, reject, revoke	`dws oa`
`pat`	Behavior authorization management	`dws pat`
`report`	Logs/reports: create by template, inbox, sent, statistics	`dws report`
`sheet`	DingTalk spreadsheets: worksheets, cells, formulas, images, find/replace	`dws sheet`
`todo`	Todos: create, query, update, complete, delete	`dws todo`
`wiki`	DingTalk wiki spaces and knowledge-base nodes	`dws wiki`

Authentication

Before any DingTalk operation, verify auth status first:

dws auth status --format json

If authenticated is false, start the login flow. This environment has no browser (Docker/SSH), so always use the device flow:

dws auth login --device

The command outputs an authorization URL, then waits with the prompt Waiting for user authorization. At this point:

Show the authorization URL to the user
Ask the user to open the URL in a browser or DingTalk mobile app to complete authorization
The command will automatically detect the authorization and proceed

To force re-login (e.g. token expired):

dws auth login --device --force

When Unsure About a Command

Always check --help before guessing parameters.

dws --help
dws <product> --help
dws <product> <command> --help

Examples:

dws chat --help
dws calendar event list --help
dws aitable record --help

---name: dingtalk-clidescription: Use when the user wants to interact with DingTalk in any way — including but not limited to: reading, querying, searching, sending, replying to, forwarding, or recalling DingTalk chat messages and chat history; managing group chats and conversations; sending DING alerts; querying contacts, org structure, AI search, or coworkers; reading, searching, creating, or editing DingTalk docs, drive files, sheets, AI tables, wiki, mail, calendar events, meeting rooms, AI meeting minutes, attendance, OA approvals, todos, reports/logs, live sessions, AI apps, permissions, or open-platform docs.--- # DingTalk CLI Skill Index **Before doing anything**, you MUST load the `dws` skill first. It contains the full product reference, command syntax, intent routing decision tree, dangerous operation rules, and error handling guide. Do not proceed without reading it. ``` read_skills(skill_names=["dws"]) ``` --- ## Product Overview | Product | Use for | CLI entry | |---------|---------|-----------| | `aiapp` | AI apps: create, query, update | `dws aiapp` | | `aisearch` | AI search: find people by name, employee number, phone, department, responsibility, reporting lines | `dws aisearch` | | `aitable` | AI tables: bases, tables, fields, records, views, charts, dashboards, import/export | `dws aitable` | | `attendance` | Attendance: punch records, shift schedules, statistics | `dws attendance` | | `calendar` | Calendar: events, attendees, meeting rooms, availability | `dws calendar` | | `chat` | Conversations, group chats, bot messaging, single chat, Webhook, message history, direct/group message list, sender filters, unread conversations, keyword and advanced message search, read/send status, send/reply/forward/recall | `dws chat` | | `contact` | Contacts: user lookup, department structure | `dws contact` | | `devdoc` | DingTalk open platform developer documentation search | `dws devdoc` | | `ding` | DING alerts: send/recall (in-app / SMS / phone) | `dws ding` | | `doc` | DingTalk docs: search, read, write, block edit, comments, copy/move | `dws doc` | | `drive` | Cloud drive: file list, upload, download, folders | `dws drive` | | `live` | Live sessions: list and info | `dws live` | | `mail` | Mail: search, view, send | `dws mail` | | `minutes` | AI meeting minutes: list, summary, transcript, todos, mindmap | `dws minutes` | | `oa` | OA approvals: pending, submitted, approve, reject, revoke | `dws oa` | | `pat` | Behavior authorization management | `dws pat` | | `report` | Logs/reports: create by template, inbox, sent, statistics | `dws report` | | `sheet` | DingTalk spreadsheets: worksheets, cells, formulas, images, find/replace | `dws sheet` | | `todo` | Todos: create, query, update, complete, delete | `dws todo` | | `wiki` | DingTalk wiki spaces and knowledge-base nodes | `dws wiki` | --- ## Authentication Before any DingTalk operation, verify auth status first: ```bash dws auth status --format json ``` If `authenticated` is `false`, start the login flow. This environment has no browser (Docker/SSH), so always use the device flow: ```bash dws auth login --device ``` The command outputs an authorization URL, then waits with the prompt `Waiting for user authorization`. At this point: 1. Show the authorization URL to the user 2. Ask the user to open the URL in a browser or DingTalk mobile app to complete authorization 3. The command will automatically detect the authorization and proceed To force re-login (e.g. token expired): ```bash dws auth login --device --force ``` --- ## When Unsure About a Command Always check `--help` before guessing parameters. ```bash dws --help dws <product> --help dws <product> <command> --help ``` Examples: ```bash dws chat --help dws calendar event list --help dws aitable record --help ```

Frequently asked questions