dingtalk-cli

Operate DingTalk messages, docs, calendar, approvals, and contacts through the dws CLI.

5.0k|557|Updated May 14, 2025
One-click install
npx skills add https://github.com/dtyq/magic --skill dingtalk-cli
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dingtalk-cli
Source: https://github.com/dtyq/magic/tree/main/backend/super-magic/agents/skills/dingtalk-cli
Command: npx skills add https://github.com/dtyq/magic --skill dingtalk-cli

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Working with DingTalk data normally requires switching between many apps and APIs. This Skill lets an AI agent perform DingTalk operations directly through the dws command-line tool, covering messaging, documents, calendar, approvals, and more from one interface.

Core Features & Use Cases

  • Messaging & Chat Management: Send, reply to, forward, recall, and search DingTalk chat messages, manage group conversations, and send DING alerts via in-app, SMS, or phone.
  • Docs, Sheets & Drive: Search, read, create, and edit DingTalk docs, spreadsheets, wiki nodes, AI tables, and cloud drive files.
  • Productivity & Org Tools: Query contacts and org structure, manage calendar events and meeting rooms, handle OA approvals, todos, attendance, mail, reports, and AI meeting minutes.
  • Use Case: Ask the agent to find all unread messages from a specific colleague, summarize them, and then schedule a follow-up meeting with a calendar invite — all without leaving the conversation.

Quick Start

Ask the agent to check DingTalk auth status with dws and then list your unread chat messages.

Frequently Asked Questions about dingtalk-cli

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send DingTalk messages from the command line?

Use the dws chat subcommand to send, reply to, forward, or recall messages in single or group chats. Run dws chat --help to see the exact parameters for each messaging operation.

How to authenticate the dws CLI without a browser?

Run dws auth login --device to start the device authorization flow. The command prints a URL for the user to open in a browser or the DingTalk mobile app, then automatically detects completion.

What DingTalk products does the dws CLI support?

The dws CLI covers twenty products including chat, doc, sheet, drive, wiki, calendar, mail, todo, oa approvals, attendance, contacts, AI tables, AI search, meeting minutes, live sessions, reports, and DING alerts.

Can I search and edit DingTalk docs and sheets programmatically?

Yes. Use dws doc for searching, reading, writing, and block-level editing of documents, and dws sheet for worksheet cells, formulas, images, and find/replace operations.

What should I do when a dws command fails or parameters are unclear?

Check the built-in help before guessing parameters: run dws --help, dws <product> --help, or dws <product> <command> --help. Also verify authentication first with dws auth status --format json.