mcp-dingding-bot MCP Server

Use This MCP server To

Send plain text notifications to DingDing group chats Deliver markdown formatted messages to DingDing groups Automatically mention all members in DingDing group messages Integrate DingDing messaging into automated alert systems Enable real-time team notifications via DingDing bots Use DingDing bot for status updates in group chats

README

MCP DingDing Bot

MCP Server for the DingDing Bot API, enabling DingDing / Dingtalk message notifications and interactions.

Features

Message Notifications: Send various types of DingDing messages (text / markdown)

Tools

send_text_message
- Send a plain text message to a dingding group
- Inputs:
  - text (string): Text content
  - atAll (optional boolean): Whether to @ all members
send_markdown_message
- Send a markdown formatted message to a dingding group
- Inputs:
  - title (string): Message title
  - text (string): Markdown content
  - atAll (optional boolean): Whether to @ all members

Setup

DingDing Bot Token

Create a DingDing group chat bot:
- Go to group settings > Group Bot Management
- Create a custom bot
- Save the webhook URL and secret

Usage with Claude Desktop

Add the following to your claude_desktop_config.json:

Docker

{
  "mcpServers": {
    "gitlab": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e",
        "DINGTALK_BOT_ACCESS_TOKEN",
        "-e",
        "DINGTALK_BOT_SECRET",
        "shawyeok/mcp-dingding-bot"
      ],
      "env": {
        "DINGTALK_BOT_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "DINGTALK_BOT_SECRET": "<YOUR_SECRET>" // Optional, for robots with signature verification enabled
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "gitlab": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-dingding-bot"
      ],
      "env": {
        "DINGTALK_BOT_ACCESS_TOKEN": "<YOUR_ACCESS_TOKEN>",
        "DINGTALK_BOT_SECRET": "<YOUR_SECRET>" // Optional, for robots with signature verification enabled
      }
    }
  }
}

Build

Docker build:

docker build -t shawyeok/mcp-dingding-bot .

Environment Variables

DINGTALK_BOT_ACCESS_TOKEN: Your dingding group robot access token (required)
DINGTALK_BOT_SECRET: Your dingding group robot signature secret (optional)

References

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

mcp-dingding-bot FAQ

How do I set up the DingDing bot token for this MCP server?

Create a DingDing group chat bot via group settings > Group Bot Management, then save the webhook URL and secret for configuration.

Can this server send both plain text and markdown messages?

Yes, it supports sending both text and markdown formatted messages to DingDing groups.

Is it possible to mention all members in a DingDing group message?

Yes, you can optionally @ all members by setting the 'atAll' parameter to true.

How do I integrate this MCP server with Claude Desktop?

Add the server configuration to your claude_desktop_config.json file as per the setup instructions.

What inputs are required to send a markdown message?

You need to provide a title, markdown text content, and optionally the 'atAll' boolean to mention all members.

Does this server support secure communication with DingDing?

Yes, it uses the webhook URL and secret from DingDing's custom bot setup to authenticate messages.

Can I use this MCP server in Docker environments?

Yes, the server can be deployed and configured using Docker as described in the setup documentation.