钉钉MCP Server

🚀 功能特性

钉钉通讯录
钉钉部门管理
钉钉机器人发消息/DING
钉钉企业文化荣誉
钉钉待办
钉钉日程
钉钉签到
钉钉工作通知
钉钉应用管理
钉钉服务窗
钉钉项目管理
钉钉日志

如何使用

{
   "mcpServers": {
      "dingtalk-mcp": {
         "command": "npx",
         "args": [
            "-y",
            "dingtalk-mcp@latest"
         ],
         "env": {
            "DINGTALK_Client_ID": "your dingtalk client id",
            "DINGTALK_Client_Secret": "your dingtalk client secret",
           "ACTIVE_PROFILES": "dingtalk-contacts,dingtalk-calendar"
         }
      }
   }
}

env环境变量说明

DINGTALK_Client_ID
DINGTALK_Client_Secret
ACTIVE_PROFILES，激活哪些钉钉MCP服务，逗号风格，如果是ALL则激活全部。可选集合

ProfileId	Description	Permission
dingtalk-contacts	钉钉通讯录，默认激活	qyapi_addresslist_search qyapi_get_member
dingtalk-department	钉钉部门管理	qyapi_get_department_list qyapi_get_department_member
dingtalk-robot-send-message	钉钉机器人发消息/DING，默认激活	需要企业内机器人发送消息权限 Premium.Ding.Write
dingtalk-honor	钉钉企业文化荣誉	OrgCulture.Honor.Read OrgCulture.Honor.Read
dingtalk-tasks	钉钉待办	Todo.Todo.Write Todo.Todo.Read
dingtalk-calendar	钉钉日程	Calendar.Event.Write Calendar.Event.Read Calendar.EventSchedule.Read
dingtalk-checkin	钉钉签到	qyapi_checkin_read
dingtalk-notice	钉钉工作通知
dingtalk-app-manage	钉钉应用管理	qyapi_microapp_manage qyapi_get_microapp_list
dingtalk-service-window	钉钉服务窗	OfficialAccount.Message.Send OfficialAccount.Contact.Read OfficialAccount.Account.Read
dingtalk-teambition	钉钉项目管理	Project.Project.Write.All Project.Project.Read.All Project.Task.Write.All Project.Task.Read.All
dingtalk-report	钉钉日志	qyapi_report_statistics qyapi_report_manage qyapi_report_query

ROBOT_CODE，用于发消息/DING的机器人Code
ROBOT_ACCESS_TOKEN，群自定义机器人ACCESS_TOKEN，用于自定义机器人发消息
DINGTALK_AGENT_ID 用于发送工作通知

如何获取钉钉Client ID和Client Secret

成为钉钉开发者
创建应用
进入应用详情页-凭证与基础信息，获取Client ID和Client Secret
添加权限，根据启用的MCP服务添加相关权限点

如何获取ROBOT_CODE

参考如何创建机器人

📞 支持

帮助文档： https://open.dingtalk.com/document/ai-dev/dingtalk-server-api-mcp-overview
钉钉开放平台: https://open.dingtalk.com
MCP协议: https://modelcontextprotocol.io
欢迎加入钉钉MCP交流群

工具列表

searchUser: 根据姓名搜索钉钉用户的userId。
getUserDetailByUserId: 查询用户详情 - 根据userId获取用户的详细信息，包含用户的unionId。
getUserIdByMobile: 根据手机号获取用户的userId。
getUserIdByUnionId: 根据unionId获取用户的userId。
getDepartmentUsersByDepId: 获取指定部门下的所有成员的userId。
sendDINGMessageByRobot: 机器人发送DING消息
recallDINGMessage: 撤回机器人发送DING的消息
sendGroupMessageByRobot: 机器人发送群消息
recallGroupMessageByRobot: 撤回机器人发送的群消息
batchSendUserMessageByRobot: 机器人批量给人发送消息
batchRecallUserMessageByRobot: 批量撤回机器人给人发送的消息
sendMessageByCustomRobot: 群自定义机器人发送群消息

服务配置

[{'mcpServers': {'dingtalk-mcp': {'args': ['-y', 'dingtalk-mcp@latest'], 'command': 'npx', 'env': {'ACTIVE_PROFILES': 'dingtalk-contacts,dingtalk-calendar', 'DINGTALK_Client_ID': 'your dingtalk client id', 'DINGTALK_Client_Secret': 'your dingtalk client secret'}}}}]

来源

来源：ModelScope
链接：https://github.com/open-dingtalk/dingtalk-mcp/blob/main/README.md