About mcp-dingding-bot
mcp-dingding-bot is an MCP server for DingDing (Dingtalk) group custom robots. It sends text or Markdown notifications through the bot API and can optionally mention all group members.
Key features
- 01Send plain text messages
- 02Send Markdown messages
- 03Optionally mention all members
Use cases
- 01Send text notifications to a group
- 02Post formatted Markdown messages in a group
- 03Send announcements that mention all members
MCP support
It exposes text and Markdown message-sending tools to MCP clients, delivering messages through a DingDing group robot.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
Tools
Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.
Details
From the project READMEMCP 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 contentatAll(optional boolean): Whether to @ all members
-
send_markdown_message- Send a markdown formatted message to a dingding group
- Inputs:
title(string): Message titletext(string): Markdown contentatAll(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.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
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.
