DingTalk

钉钉MCP服务

javascript

13

GitHub Stars

javascript

Language

6 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can run a DingTalk MCP Server to access a wide range of DingTalk services through a unified MCP interface. This server lets you manage contacts, departments, calendars, robots, reminders, check-ins, and more, all via configurable profiles and a single runtime.

How to use

To use this MCP server, start the server via your MCP client. You deploy a local stdio MCP endpoint by running the provided command through a runtime like Node.js using the npx tool. Set the environment variables to authenticate with DingTalk and choose the active service profiles you want to enable. The MCP client will connect to your local server process and expose the DingTalk features you activated.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

Install Node.js and npm if they are not already installed. You can verify with:
Run the MCP server configuration snippet below to start the server via npx. This will fetch the latest DingTalk MCP package and start it with your credentials and profile selections.
After the server starts, your MCP client can connect to the stdio endpoint and access the enabled features.

Configuration and usage notes

Environment variables control authentication and which DingTalk services are active. You can customize the client ID, client secret, and the set of active profiles. Active profiles are a comma-separated list of features you want to enable, for example: dingtalk-contacts,dingtalk-calendar. If you set ALL, all features are activated.

The list of supported profiles includes: dingtalk-contacts, dingtalk-department, dingtalk-robot-send-message, dingtalk-honor, dingtalk-tasks, dingtalk-calendar, dingtalk-checkin, dingtalk-notice, dingtalk-app-manage, dingtalk-service-window, dingtalk-teambition, and dingtalk-report. Each profile maps to specific permissions within the DingTalk API.

To obtain the required credentials, create a DingTalk developer application, generate the Client ID and Client Secret, and grant permissions corresponding to the enabled profiles. The ROBOT_CODE and ROBOT_ACCESS_TOKEN values are used for robot messaging integration, and DINGTALK_AGENT_ID is used for work notifications.

Troubleshooting and tips

If you encounter permissions errors, re-check the enabled profiles against the DingTalk permissions you granted for your application. Ensure your Client ID and Client Secret are correct and that your environment variables are exported to the runtime when starting the MCP server.

For common connectivity issues, confirm the MCP runtime process is running and that your MCP client is configured to connect to the local stdio endpoint. Review any error messages from the startup phase and re-apply the correct ENV values if needed.

Available tools

contacts

Access to DingTalk contacts data, enabling address list searches and member lookups.

department

Access to DingTalk department information and member lists.

robot_message

Send messages via DingTalk robots and DING to groups or chats.

honor

Access DingTalk corporate honors and cultural data.

tasks

Manage and read DingTalk tasks and to-dos.

calendar

Read and write DingTalk calendar events and schedules.

checkin

Read check-in data and perform check-in operations.

notice

Distribute work notices via DingTalk.

app_manage

Manage DingTalk microapps and application lists.

service_window

Interact with DingTalk service window messages and contacts.

teambition

Manage DingTalk project and task collections.

report

Access DingTalk activity and usage reports.