Dingtalk MCP

Name: Dingtalk MCP
Author: open-dingtalk

Local

github.com/open-dingtalkCommunication26Updated 69w ago

Repository

About Dingtalk MCP

DingTalk MCP Server is an MCP server built on the DingTalk OpenAPI, covering contacts, departments, calendar, tasks, check-in, work notices and project management. Enterprises can enable only the modules they need and configure them with their own application credentials.

Key features

01Contacts and department management
02Robot messaging and DING reminders
03Calendar, tasks and check-in
04Work notifications and app management
05Project management and report queries

Use cases

01Querying enterprise contacts and department members from an AI assistant
02Sending group messages or DING reminders through a robot
03Supporting daily office work with calendar and task data

MCP support

This project is an MCP server that exposes the DingTalk OpenAPI modules as MCP capabilities to clients. The ACTIVE_PROFILES environment variable selects which modules are enabled, and clients launch it with npx.

#dingtalk #mcp #server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config

{
  "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>"
      }
    }
  }
}

Run commandnpx -y dingtalk-mcp

Environment variables to set

DINGTALK_Client_ID

DINGTALK_Client_SecretSecret

ACTIVE_PROFILES

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages

npmdingtalk-mcpstdio

Tools

Saved tool list · updated 2w ago

Parameter	Type	Required	Description
opUnionId	string	Yes	The operator's unionId. This user must be an administrator with application management permissions.
name	string	Yes	Application name. Length must be 2–20 characters.
desc	string	Yes	Application description. Maximum length: 200 characters.
icon	string	No	Application icon media_id
homepageLink	string	No	Application homepage URL. Required for H5 micro-apps.
pcHomepageLink	string	No	Application URL for PC
ompLink	string	No	Application management console URL
ipWhiteList	array	No	Server egress IP allowlist. Maximum of 50 entries.
scopeType	string	No	Permission type. Currently, only BASE is supported.
developType	number	No	Type of internal app to create: 0 for an H5 micro app, 1 for a mini program; defaults to 0

Details

From the project 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

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交流群

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

Read the getting-started guide

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.