mcp-dingding-bot

By Shawyeok GitHub

MCP Server for send text/markdown message via dingding (aka dingtalk) group custom robot

mcp dingtalk

Overview

what is MCP DingDing Bot?

MCP DingDing Bot is a server application that allows users to send text and markdown messages via the DingDing (Dingtalk) group custom robot API.

how to use MCP DingDing Bot?

To use the MCP DingDing Bot, you need to set up a DingDing group chat bot, obtain the webhook URL and secret, and configure the bot with your access token. You can then use the provided commands to send messages to your DingDing group.

key features of MCP DingDing Bot?

Send plain text messages to DingDing groups.
Send markdown formatted messages to DingDing groups.
Option to notify all group members with @all.

use cases of MCP DingDing Bot?

Sending automated notifications to team members in a DingDing group.
Sharing updates or announcements in markdown format for better readability.
Integrating with other applications to send alerts or messages directly to DingDing.

FAQ from MCP DingDing Bot?

How do I create a DingDing group chat bot?

Go to group settings > Group Bot Management, create a custom bot, and save the webhook URL and secret.

Is the access token required?

Yes, the access token is required to authenticate your bot with DingDing.

Can I use markdown formatting in messages?

Yes, you can send messages in markdown format using the appropriate command.

Content

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:
  - content (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:

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

Environment Variables

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

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.

No tools information available.