dingtalk-mcp-server

# DingTalk MCP Server The DingTalk Model Context Protocol (MCP) server implementation allows Claude to interact with the DingTalk workspace. ## 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 information about a user - Required parameters: - `user_id` (string): User ID - Returns: Detailed information about the user, including: - Name - Employee ID - Department - Date of joining - Contact information (mobile, email, etc.) 3. `dingtalk_send_message` - Send a private message to a DingTalk user - Required parameters: - `user` (string): The name of the user receiving the message - `content` (string): Message content - Returns: Message sending confirmation ## Setup 1. Create a DingTalk application: - Visit the [DingTalk Developer Console](https://open-dev.dingtalk.com) - Click "Create Application" - Select "Enterprise Internal Application" - Fill in the application information and create 2. Configure application permissions: On the application details page, configure the following permissions: - `userinfo`: Get user information - `message`: Send messages - `user`: Get user list 3. Obtain application credentials: - Save the application's AppKey and AppSecret ### Using with Claude Desktop Add the following configuration in `claude_desktop_config.json`: #### npx Method ```json { "mcpServers": { "dingtalk": { "command": "npx", "args": [ "-y", "@darrenyao/server-dingtalk" ], "env": { "DINGTALK_APP_KEY": "your_app_key", "DINGTALK_APP_SECRET": "your_app_secret" } } } } ``` #### Docker Method ```json { "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" } } } } ``` ### Environment Variables 1. `DINGTALK_APP_KEY`: Required. The AppKey of the DingTalk application 2. `DINGTALK_APP_SECRET`: Required. The AppSecret of the DingTalk application ### Troubleshooting If you encounter permission errors, please check: 1. Whether the application has been correctly configured with the required permissions 2. Whether the application has been correctly installed in the enterprise 3. Whether the application credentials have been correctly configured 4. Whether the application has obtained the necessary access permissions ## Build Docker build: ```bash docker build -t mcp/dingtalk -f Dockerfile . ``` ## License This project is licensed 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.