Dingding Bot

🚀 DingTalk Bot MCP Server

The MCP server is designed for the DingTalk Bot API, supporting DingTalk message notifications and interactions.

🚀 Quick Start

The MCP server is used for the DingTalk Bot API, enabling DingTalk message notifications and interactions.

✨ Features

• Message Notifications: Send various types of DingTalk messages (text/Markdown).

💻 Usage Examples

Basic Usage

The MCP server provides the following tools for sending messages:

1. send_text_message

   • Send plain text messages to a DingTalk group.
   • Input parameters:
     • text (string): The text content.
     • atAll (optional boolean): Whether to @ all members.

2. send_markdown_message

   • Send Markdown-formatted messages to a DingTalk group.
   • Input parameters:
     • title (string): The message title.
     • text (string): The Markdown content.
     • atAll (optional boolean): Whether to @ all members.

📦 Installation

DingTalk Bot Token

1. Create a DingTalk group chat bot:
   • Go to Group Settings > Group Bot Management.
   • Create a custom bot.
   • Save the webhook URL and secret key.

Usage with Claude Desktop

Add the following content 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 bots 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 bots with signature verification enabled
      }
    }
  }
}

🔧 Technical Details

Build

Docker build command:

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

Environment Variables

• DINGTALK_BOT_ACCESS_TOKEN: Your DingTalk group bot access token (required).
• DINGTALK_BOT_SECRET: Your DingTalk group bot signature key (optional).

📚 Documentation

• Model Context Protocol Quickstart Server
• Custom Robot Access

📄 License

This MCP server is distributed under the MIT License. This means you are free to use, modify, and distribute the software, but you must comply with the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.