article

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

https://modelcontextprotocol.io/quickstart/server
https://open.dingtalk.com/document/robots/custom-robot-access

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