# 钉钉MCP Server



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

## 如何使用
```json
{
   "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
2. DINGTALK_Client_Secret
3. 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，默认激活 | 需要企业内机器人发送消息权限 <br/>Premium.Ding.Write	                                  |
| dingtalk-honor              | 钉钉企业文化荣誉           |OrgCulture.Honor.Read	OrgCulture.Honor.Read	
| dingtalk-tasks              | 钉钉待办               | Todo.Todo.Write<br>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<br>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. [成为钉钉开发者](https://open.dingtalk.com/document/orgapp/obtain-developer-permissions)
2. [创建应用](https://open.dingtalk.com/document/orgapp/create-an-application)
3. 进入应用详情页-凭证与基础信息，获取Client ID和Client Secret
4. [添加权限](https://open.dingtalk.com/document/orgapp/add-api-permission)，根据启用的MCP服务添加相关权限点
### 如何获取ROBOT_CODE
1. 参考[如何创建机器人](https://open.dingtalk.com/document/orgapp/the-creation-and-installation-of-the-application-robot-in-the)


## 📞 支持

- 帮助文档： https://open.dingtalk.com/document/ai-dev/dingtalk-server-api-mcp-overview
- 钉钉开放平台: https://open.dingtalk.com
- MCP协议: https://modelcontextprotocol.io
- 欢迎加入钉钉MCP交流群
  ![欢迎加入钉钉MCP交流群](https://img.alicdn.com/imgextra/i4/O1CN01QEZnE31yZBvlEHXss_!!6000000006592-2-tps-864-938.png)