Dingtalk MCP

Name: Dingtalk MCP
Author: open-dingtalk

本地服务

github.com/open-dingtalk通信协作2669 周前更新

代码仓库

关于 Dingtalk MCP

钉钉 MCP Server 是钉钉开放平台 OpenAPI 的 MCP 服务，覆盖通讯录、部门、日程、待办、签到、工作通知、项目管理等企业办公场景。企业可按需启用对应的服务模块，并使用自有应用凭证进行配置。

主要功能

01通讯录与部门管理
02机器人发送消息与 DING
03日程、待办与签到
04工作通知与应用管理
05项目管理与日志查询

适用场景

01通过 AI 助手查询企业通讯录和部门成员
02让机器人向群组发送消息或 DING 提醒
03基于日程与待办信息辅助日常办公

MCP 相关

该项目是一个 MCP 服务，将钉钉 OpenAPI 的各功能模块以 MCP 能力的形式提供给客户端。通过 ACTIVE_PROFILES 环境变量可选择启用哪些模块，客户端以 npx 方式启动。

#dingtalk #mcp #server

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "dingtalk-mcp-open-dingtalk": {
      "command": "npx",
      "args": [
        "-y",
        "dingtalk-mcp"
      ],
      "env": {
        "DINGTALK_Client_ID": "<DINGTALK_Client_ID>",
        "DINGTALK_Client_Secret": "<DINGTALK_Client_Secret>",
        "ACTIVE_PROFILES": "<ACTIVE_PROFILES>"
      }
    }
  }
}

启动命令npx -y dingtalk-mcp

需要配置的环境变量

DINGTALK_Client_ID

DINGTALK_Client_Secret密钥

ACTIVE_PROFILES

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npmdingtalk-mcpstdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
opUnionId	string	是	操作人的unionId，该用户必须是拥有应用管理权限的管理员
name	string	是	应用名称，长度范围要求2-20个字符
desc	string	是	应用描述，最大长度200个字符
icon	string	否	应用图标media_id
homepageLink	string	否	应用首页地址，H5微应用时必传
pcHomepageLink	string	否	应用PC端地址
ompLink	string	否	应用管理后台地址
ipWhiteList	array	否	服务器出口IP白名单列表，最大值50
scopeType	string	否	权限类型，目前只支持BASE
developType	number	否	创建的内部应用类型，0 为 H5 微应用，1 为小程序，默认为 0

详细介绍

来自项目 README

钉钉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