Dingtalk MCP Server

🚀 DingTalk MCP Server

This is an implementation of the Model Context Protocol (MCP) server for DingTalk, enabling Claude to interact with DingTalk workspaces.

🚀 Quick Start

✨ Features

The DingTalk MCP server provides the following key features:

• Enables Claude to interact with DingTalk workspaces.
• Offers a set of tools for user search, user information retrieval, and message sending.

📦 Installation

Prerequisites

• Create a DingTalk application:
  • Visit the DingTalk Developer Console.
  • Click "Create Application".
  • Select "Internal Corporate Application".
  • Fill in the application information and create it.
• Configure application permissions: On the application details page, configure the following permissions:
  • userinfo: Get user information.
  • message: Send messages.
  • user: Get the user list.
• Obtain application credentials: Save the application's AppKey and AppSecret.

💻 Usage Examples

Tools

1. dingtalk_search_users

   • Search for DingTalk users.
   • Required parameters:
     • query (string): Search keyword.
   • Optional parameters:
     • exact_match (boolean, default: false): Whether to perform an exact match.
   • Returns: A list of matching users and their basic information.

2. dingtalk_get_user_info

   • Get detailed user information.
   • Required parameters:
     • user_id (string): User ID.
   • Returns: Detailed user information, including:
     • Name
     • Employee ID
     • Department
     • Hire date
     • Contact information (phone, email, etc.)

3. dingtalk_send_message

   • Send a private message to a DingTalk user.
   • Required parameters:
     • user (string): The name of the user who will receive the message.
     • content (string): Message content.
   • Returns: Confirmation of message sending.

Configuration with Claude Desktop

Add the following configuration to claude_desktop_config.json:

npx Method

{
  "mcpServers": {
    "dingtalk": {
      "command": "npx",
      "args": [
        "-y",
        "@darrenyao/server-dingtalk"
      ],
      "env": {
        "DINGTALK_APP_KEY": "your_app_key",
        "DINGTALK_APP_SECRET": "your_app_secret"
      }
    }
  }
}

Docker Method

{
  "mcpServers": {
    "dingtalk": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DINGTALK_APP_KEY",
        "-e",
        "DINGTALK_APP_SECRET",
        "mcp/dingtalk"
      ],
      "env": {
        "DINGTALK_APP_KEY": "your_app_key",
        "DINGTALK_APP_SECRET": "your_app_secret"
      }
    }
  }
}