Dingtalk MCP
@open-dingtalk
About Dingtalk MCP
钉钉OpenAPI MCP Server.
Basic information
Config
Add this server to your MCP-compatible client using the configuration below.
{
"mcpServers": {
"dingtalk": {
"command": "npx",
"args": [
"-y",
"dingtalk-mcp@latest"
],
"env": {
"DINGTALK_Client_ID": "your dingtalk app client id",
"DINGTALK_Client_Secret": "your dingtalk app cliengt secret",
"ACTIVE_PROFILES": "ALL"
}
}
}
}Tools
60创建企业内部应用，支持H5微应用和小程序两种类型
更新企业内部应用信息，包括应用名称、描述、图标、链接等
获取企业所有应用列表，包括基础应用、自建应用和第三方应用
获取企业内部所有应用列表，仅限内部开发的应用
获取指定用户可使用的企业应用列表及应用信息
获取企业内部应用的可使用范围信息（用户、部门、角色）
更新企业内部应用的可使用范围，支持增删用户、部门、角色
发布企业内部小程序版本，支持线上版本和体验版本
回滚企业内部小程序到历史版本
获取企业内部小程序的所有版本信息
分页获取企业内部小程序历史版本列表
向指定日程添加参与者，支持批量添加多人，可设置参与者类型和通知方式
创建新的日程，支持设置时间、参与者、提醒等完整功能
删除指定日程，组织者删除将通知所有参与者，参与者删除仅从自己日历移除
查询指定时间范围内的日程视图，支持循环日程展开显示
获取指定日程的详细信息，包含完整的参与者、位置、描述等信息
获取指定日程的所有参与者列表及其状态信息
查询指定时间范围内的日程列表，支持分页和增量同步
修改现有日程的信息，支持更新标题、时间、参与者、地点等任意字段，仅需要组织者权限
从指定日程中移除参与者，支持批量移除多人
获取部门用户签到记录，以部门维度获取员工签到记录进行统计分析
获取指定用户的签到记录，可获取指定人员的签到记录进行统计分析
根据姓名搜索钉钉用户的userId。
查询用户详情 - 根据userId获取用户的详细信息，包含用户的unionId。
根据手机号获取用户的userId。
根据unionId获取用户的userId。
获取指定部门下的所有成员的userId。
获取指定部门的详细信息，包括部门名称、父部门、管理员、权限设置等完整信息
根据部门名称搜索部门ID，支持部门名称或拼音搜索
获取指定部门的下一级子部门基础信息列表
获取指定部门下的所有直属子部门ID列表
获取指定部门的所有父部门ID列表，从当前部门到根部门的完整路径
获取指定用户所属的所有父级部门路径，返回用户所有部门归属的层级结构
给组织内的员工颁发荣誉，支持单人或多人批量颁发。 颁发后员工会收到荣誉推送消息，可以选择佩戴荣誉挂件。 注意：同一个颁发人不允许并发执行，需要串行调用。
查询当前企业下可颁发的荣誉列表，包括荣誉ID、名称、描述、图标等信息。 支持分页查询，可用于展示荣誉选择列表。
查询某个员工获得的组织荣誉记录，包括荣誉ID、名称、授予时间、发放人等信息。 可用于展示员工的荣誉墙或荣誉历史。
创建企业荣誉勋章模板。创建后会流入钉钉后台审核，一般5个工作日内审核完毕。 注意事项： 1. 需要主管理员或子管理员权限 2. 企业每周的审核次数有限制（标准版每周10次/专业版每周20次） 3. 不允许并发调用，如需批量创建请串行执行 4. 图片需要先调用上传媒体文件接口获取media_id
撤销员工已获得的荣誉勋章。 撤销后员工将无法继续佩戴该荣誉。
发送工作通知消息，支持 markdown 消息类型
获取工作通知消息的发送结果，查询消息发送状态和统计信息
获取工作通知消息的发送进度，实时查询消息发送进度
撤回已发送的工作通知消息，消息撤回后接收人将无法看到该消息
机器人发送DING消息
撤回机器人发送DING的消息
机器人发送群消息
撤回机器人发送的群消息
机器人批量给人发送消息
批量撤回机器人给人发送的消息
群自定义机器人发送群消息
发送服务窗单人消息
批量发送服务窗消息
获取关注服务窗的单个用户信息
批量获取关注服务窗用户的信息
获取用户的服务窗关注状态
获取企业下的服务窗列表，以获取服务窗帐号IDaccountId
查询钉钉待办/任务列表
删除钉钉待办
创建待办
更新待办
更新执行人待办状态
Overview
What is 钉钉MCP Server?
钉钉MCP Server是一个基于Model Context Protocol（MCP）的服务器，它将钉钉开放平台的多项API封装为MCP工具，使AI助手能够通过自然语言调用钉钉功能。该服务器面向需要使用AI操作钉钉通讯录、部门、机器人消息、待办、日程、签到、工作通知、应用管理、服务窗等场景的开发者和企业。
How to use 钉钉MCP Server?
通过配置MCP客户端（如Claude Desktop）的mcpServers，添加名为dingtalk-mcp的服务器，使用npx -y dingtalk-mcp@latest命令运行，并设置环境变量DINGTALK_Client_ID和DINGTALK_Client_Secret。通过ACTIVE_PROFILES环境变量激活所需的功能模块（如dingtalk-contacts,dingtalk-calendar），设置为ALL则激活全部服务。其他可选变量包括ROBOT_CODE、ROBOT_ACCESS_TOKEN和DINGTALK_AGENT_ID。
Key features of 钉钉MCP Server
- 提供钉钉通讯录与部门管理工具
- 支持机器人发送消息和DING通知
- 管理钉钉待办事项（读写权限）
- 操作钉钉日程、签到、工作通知
- 集成钉钉企业文化荣誉管理
- 覆盖钉钉应用管理与服务窗接口
Use cases of 钉钉MCP Server
- 通过AI助手快速查询企业内部员工通讯录
- 自动向钉钉群发送定时消息或DING提醒
- 创建和跟踪团队待办任务
- 管理员工日程并查看签到情况
- 发送工作通知到指定人员或部门
FAQ from 钉钉MCP Server
如何获取钉钉Client ID和Client Secret？
需要先在钉钉开放平台注册成为开发者，创建应用后从应用详情页的“凭证与基础信息”中获取Client ID和Client Secret，并根据启用的MCP服务添加相应的API权限。
如何获取机器人Code用于发送消息？
参考钉钉官方文档“创建机器人”，在应用中配置机器人后获得机器人Code，再通过环境变量ROBOT_CODE设置即可。
环境变量ACTIVE_PROFILES如何配置？
该变量用于激活指定的MCP服务，多个服务用逗号分隔，例如dingtalk-contacts,dingtalk-calendar；设置为ALL则激活全部已列出的服务。默认激活通讯录和机器人发送消息两个模块。
有哪些依赖或运行环境要求？
需要Node.js环境，通过npx运行；无需本地安装，但需要外网访问钉钉开放平台的API。钉钉Client ID和Client Secret必须提前获取。
支持哪些传输和认证方式？
使用钉钉OAuth 2.0的Client ID和Client Secret进行认证，通过环境变量传入；服务器与MCP客户端之间采用标准的stdio传输协议。
More Other MCP servers
Inbox Zero AI
elie222The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.
Activepieces
activepiecesAI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
XcodeBuildMCP
cameroncookeA Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Production-ready MCP integrations for AI applications
Klavis-AIKlavis AI: MCP integration platforms that let AI agents use tools reliably at any scale
IDA Pro MCP
mrexodiaAI-powered reverse engineering assistant that bridges IDA Pro with language models through MCP.
Comments