# 钉钉

消息、文档、表格、日志、日历与待办的查询和操作。

- 类型：MCP · CLI
- 权限：可执行操作
- 门槛：需授权账号、需 API Key
- 官方入口：https://open.dingtalk.com/document/ai-dev/dingtalk-server-api-mcp-overview
- 网页详情：https://guanmo-ai.github.io/awesome-agent-mcp/s/dingtalk/

仅供参考，官方身份核验不代表接入实测；以厂商文档为准，密钥和登录在本地完成。修改或发送前须告知用户。

## 接入前准备

官方企业应用 MCP 需要钉钉企业管理员或子管理员申请接口权限，普通成员需管理员协助准备企业内部应用、AppKey、AppSecret 和对应权限后使用；不能只凭个人登录接入。需 Node.js >= 16。CLI 的普通成员独立开通条件及企业版、费用要求，所引官方说明未说明。 下方摘录仅证明通讯录敏感权限的角色限制，其他接口以各自权限说明为准。

## 接入步骤

1. 使用企业应用 MCP 时，请管理员创建企业内部应用、取得 AppKey/AppSecret 并开通所需接口权限；按官方 npx 配置接入。示例 ACTIVE_PROFILES=ALL 覆盖全部模块，实际接入按高级配置缩小为任务所需模块。 [官方入口](https://open.dingtalk.com/document/ai-dev/second-level-node-1)
2. 在钉钉开放平台能力中心了解所需 MCP 服务及工具范围。 [官方入口](https://open.dingtalk.com/group)
3. 参照钉钉官方 DWS 指南安装并登录；运行 dws mcp published tools，查看当前身份可用的已发布工具与输入格式。 [官方入口](https://open.dingtalk.com/dingtalk-dev/wiki)
4. 按实际发布的工具契约选择目标与参数，从只读工具开始；使用具体客户端连接时按相应服务页面说明完成授权。 [官方入口](https://open.dingtalk.com/dingtalk-dev/wiki)

## 验证方法

MCP 路线先检查工具列表，再按官方只读示例搜索本人基本信息；CLI 路线先查看已发布工具。权限不足时记录缺少的接口权限，不以创建文档或发消息验证。

指引核对于 2026-11-05，不是本项目实测结果。

权限依据：[官方页面](https://opensource.dingtalk.com/developerpedia/docs/develop/permission/high_grade_scope/)

官方原文：可以操作该权限点的角色为【全组织通讯录管理员】

## 费用

官方接入页面当前无法直接读取，调用费用和免费额度尚未核实；请以官方实际规则为准。 [官方来源](https://open.dingtalk.com/document/ai-dev/second-level-node-1)（核对日期：2026-11-05）

## 安装配置

### JSON

```
{
  "mcpServers": {
    "dingtalk": {
      "command": "npx",
      "args": [
        "-y",
        "dingtalk-mcp@latest"
      ],
      "env": {
        "DINGTALK_Client_ID": "${DINGTALK_Client_ID}",
        "DINGTALK_Client_Secret": "${DINGTALK_Client_Secret}",
        "ACTIVE_PROFILES": "ALL"
      }
    }
  }
}
```

### Claude Code

```
claude mcp add --env 'DINGTALK_Client_ID=${DINGTALK_Client_ID}' --env 'DINGTALK_Client_Secret=${DINGTALK_Client_Secret}' --env 'ACTIVE_PROFILES=ALL' --transport stdio 'dingtalk' -- 'npx' '-y' 'dingtalk-mcp@latest'
```

### Codex

```
# ~/.codex/config.toml
[mcp_servers.dingtalk]
command = "npx"
args = ["-y","dingtalk-mcp@latest"]
env_vars = ["DINGTALK_Client_ID","DINGTALK_Client_Secret"]

[mcp_servers.dingtalk.env]
ACTIVE_PROFILES = "ALL"
```

### CLI

```
curl -fsSL https://gitee.com/DingTalk-Real-AI/dingtalk-workspace-cli/raw/main/scripts/install.sh | DWS_GITEE_REPO=DingTalk-Real-AI/dingtalk-workspace-cli sh
```

这条命令会直接执行官方脚本，请让 Agent 先读脚本内容再运行。

JSON 示例用于 Claude Code 的 .mcp.json；${VAR} 从启动客户端的环境读取。Codex 的环境变量也须在启动进程中可用，不能将变量名替换成密钥值。

命令会进入 shell 历史，请在本地执行，不要分享。保留命令中的 ${VAR} 引用；Codex 不支持在 URL 或命令参数中展开这些引用，此处保留待本地处理的占位符。

## 核验与来源

2026-11-05 核对官方身份：[依据](https://open.dingtalk.com/document/ai-dev/second-level-node-1)。钉钉官方能力中心列出消息、文档、表格、日志、日历等 MCP 服务。

官方原文摘录（2026-11-05，来自上述依据）：

```
"dingtalk-mcp@latest"
```

官方页 Agent 可能读不到；上述原文摘录已覆盖的内容无需再读取官方页，未覆盖的信息仍须核实，不要猜测。

- [厂商官方接入文档](https://open.dingtalk.com/dingtalk-dev/wiki)
- [厂商官方发布依据](https://open.dingtalk.com/)
- [官方账号与权限说明](https://open.dingtalk.com/document/ai-dev/second-level-node-1)

[使用说明与免责声明](https://guanmo-ai.github.io/awesome-agent-mcp/#disclaimer)