dingtalk-mcp

🚀 钉钉MCP Server

钉钉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环境变量说明

1. DINGTALK_Client_ID：钉钉客户端ID

2. DINGTALK_Client_Secret：钉钉客户端密钥

3. ACTIVE_PROFILES：激活哪些钉钉MCP服务，采用逗号分隔风格，如果值为 ALL 则激活全部。可选集合如下： | ProfileId | 描述 | 权限 | |-----------------------------|--------------------|--------------------------------------------------| | 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 |

4. ROBOT_CODE：用于发消息/DING的机器人Code

5. ROBOT_ACCESS_TOKEN：群自定义机器人ACCESS_TOKEN，用于自定义机器人发消息

6. DINGTALK_AGENT_ID：用于发送工作通知

如何获取钉钉Client ID和Client Secret

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

如何获取ROBOT_CODE

1. 参考如何创建机器人

📞 支持

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