Dingtalk Mcp Server
What is Dingtalk Mcp Server
dingtalk_mcp_server is an MCP Server corresponding to the DingTalk open API, allowing users to easily operate DingTalk using large models.
Use cases
Use cases include managing employee roles, creating and deleting departments, adding external contacts, and modifying user visibility settings. It can also be used for debugging and testing through the MCP Inspector.
How to use
To use dingtalk_mcp_server, first create an internal application in the DingTalk developer backend. Grant the application permission to call all APIs. Then, configure the .env file with your appkey and appsecret, and set up the necessary configurations in the Cursor and Cline settings files.
Key features
Key features include creating role groups, adding external contacts, modifying contact visibility settings, managing user roles, and creating departments. It also supports batch operations for roles and users, as well as various user attribute management functionalities.
Where to use
dingtalk_mcp_server is primarily used in enterprise environments where DingTalk is utilized for communication and collaboration. It is suitable for organizations looking to automate and enhance their DingTalk operations.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Dingtalk Mcp Server
dingtalk_mcp_server is an MCP Server corresponding to the DingTalk open API, allowing users to easily operate DingTalk using large models.
Use cases
Use cases include managing employee roles, creating and deleting departments, adding external contacts, and modifying user visibility settings. It can also be used for debugging and testing through the MCP Inspector.
How to use
To use dingtalk_mcp_server, first create an internal application in the DingTalk developer backend. Grant the application permission to call all APIs. Then, configure the .env file with your appkey and appsecret, and set up the necessary configurations in the Cursor and Cline settings files.
Key features
Key features include creating role groups, adding external contacts, modifying contact visibility settings, managing user roles, and creating departments. It also supports batch operations for roles and users, as well as various user attribute management functionalities.
Where to use
dingtalk_mcp_server is primarily used in enterprise environments where DingTalk is utilized for communication and collaboration. It is suitable for organizations looking to automate and enhance their DingTalk operations.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
dingtalk_mcp_server
dingtalk_mcp_server 是钉钉开放接口对应的 MCP Server，让你可以使用大模型轻松操作钉钉。
前置条件
- 在钉钉开发者后台创建企业内部应用。
- 给应用调用所有接口的权限
- 参考 .env.example 创建 .env 文件，并配置应用的appkey、appsecret
配置与使用
在 Cursor 中配置
在 .cursor/mcp.json 文件中添加（需要替换成自己的路径）:
{
"mcpServers": {
"dingtalk-contacts": {
"command": "uv",
"args": [
"run",
"src/main.py"
],
"env": {}
}
}
}在 Cline 中配置
在 cline_mcp_settings.json 文件中添加（需要替换成自己的）:
{
"mcpServers": {
"mcp-server-alipay": {
"command": "uv",
"args": [
"run",
"src/main.py"
],
"env": {},
"disable": false,
"autoApprove": []
}
}
}调试方法
使用 MCP Inspector 进行调试:
- 启动Inspector：
mcp dev src/main.py - 在WebUI中调试
支持的能力
| 分类 | 工具名称 | 描述 |
|---|---|---|
| 通讯录管理 | create_role_group | 调用本接口，创建角色组。 |
| 通讯录管理 | add_external_contact | 调用本接口，添加企业外部联系人。 |
| 通讯录管理 | update_or_create_contact_restriction_settings | 新增或修改员工、部门、角色限制查看通讯录的设置。 |
| 通讯录管理 | set_user_attribute_visibility | 设置用户属性可见性。 |
| 通讯录管理 | add_roles_for_employees | 批量增加员工角色。 |
| 通讯录管理 | create_role | 调用本接口，创建新角色。 |
| 通讯录管理 | search_department_id | 搜索部门ID。 |
| 通讯录管理 | search_user_id | 调用本接口，搜索用户userId。 |
| 通讯录管理 | change_dingtalk_id | 修改企业账号的钉钉号。 |
| 通讯录管理 | authorize_org_account_visibility | 授权当前组织的企业账号在加入其他组织后，可在其他组织查看企业账号信息的具体字段 。 |
| 通讯录管理 | auth_multi_org_permissions | 授权企业帐号可以加入多个组织，只有被授权后企业帐号才能加入外部组织。 |
| 通讯录管理 | create_department | 调用本接口，创建新部门。 |
| 通讯录管理 | create_sso_enterprise_account | 调用本接口创建SSO企业账号新用户。 |
| 通讯录管理 | create_dingtalk_enterprise_account | 调用本接口创建钉钉自建企业账号新用户。 |
| 通讯录管理 | delete_department | 根据部门ID删除指定部门。 |
| 通讯录管理 | delete_user | 根据用户的userid删除指定用户。 |
| 通讯录管理 | delete_staff_attribute_visibility_setting | 调用本接口删除企业员工属性字段可见性设置。 |
| 通讯录管理 | delete_external_contact | 调用本接口，删除企业外部联系人。 |
| 通讯录管理 | delete_contact_hide_setting | 删除通讯录隐藏设置。 |
| 通讯录管理 | delete_role | 根据角色ID删除指定的角色。 |
| 通讯录管理 | batch_remove_employee_roles | 调用本接口批量删除员工的角色。 |
| 通讯录管理 | delete_restricted_contact_setting | 根据限制查看通讯录设置ID，执行删除操作。 |
| 通讯录管理 | get_user_contact_info | 调用本接口获取企业用户通讯录中的个人信息。 |
| 通讯录管理 | disable_org_account | 调用本接口，停用指定的企业帐号。 |
| 通讯录管理 | enable_org_account | 启用指定企业帐号。 |
| 通讯录管理 | force_logout_org_account | 强制登出指定的企业帐号。 |
| 通讯录管理 | get_senior_mode_settings | 获取用户高管模式设置。 |
| 通讯录管理 | get_contact_restrictions_settings | 获取通讯录限制可见性设置信息列表。 |
| 通讯录管理 | get_department_detail | 根据部门ID获取部门详情。 |
| 通讯录管理 | invite_other_org_account | 调用本接口加入其他组织企业账号进入本组织。 |
| 通讯录管理 | get_sub_department_id_list | 获取企业部门下的所有直属子部门ID列表。 |
| 通讯录管理 | get_auth_scopes | 获取通讯录权限范围，调用通讯录相关接口前需要通过此接口确认权限。 |
| 通讯录管理 | get_corp_auth_info | 调用本接口，获取企业认证信息。 |
| 通讯录管理 | get_enterprise_info | 调用本接口，获取行业通讯录的企业信息。 |
| 通讯录管理 | get_enterprise_invite_info | 调用本接口，获取企业的邀请信息。 |
| 通讯录管理 | get_department_list | 根据部门ID获取下一级部门基础信息。 |
| 通讯录管理 | get_external_contact_list | 调用本接口，获取企业外部联系人列表。 |
| 通讯录管理 | get_employee_list_by_role | 获取指定角色的员工列表。 |
| 通讯录管理 | get_employee_count | 调用本接口获取员工人数。 |
| 通讯录管理 | get_user_by_mobile | 根据手机号查询企业账号用户。 |
| 通讯录管理 | get_role_list | 调用本接口，获取角色列表。 |
| 通讯录管理 | get_external_contact_label_list | 获取企业外部联系人的标签列表。 |
| 通讯录管理 | get_department_list | 根据部门ID获取行业通讯录部门列表。 |
| 通讯录管理 | get_external_contact_details | 获取企业外部联系人的详细信息。 |
| 通讯录管理 | get_contact_hide_settings | 批量获取通讯录隐藏设置信息列表。 |
| 通讯录管理 | get_department_user_list | 调用本接口，获取部门下的人员列表信息。 |
| 通讯录管理 | get_role_group_list | 调用本接口，获取角色组信息。 |
| 通讯录管理 | get_user_attribute_visibility_settings | 调用本接口获取用户属性可见性设置。 |
| 通讯录管理 | get_department_user_details | 调用本接口获取指定部门中的用户详细信息。 |
| 通讯录管理 | get_department_user_detail | 获取部门用户详情。 |
| 通讯录管理 | get_role_details | 根据角色ID获取指定角色详情。 |
| 通讯录管理 | get_department_user_details | 调用本接口获取指定部门中的用户详细信息。 |
| 通讯录管理 | get_user_detail | 查询企业账号用户的详细信息。 |
| 通讯录管理 | get_inactive_user_list | 调用本接口查询指定日期内未登录钉钉的企业员工列表。 |
| 通讯录管理 | get_ding_index | 调用本接口获取企业最新钉钉指数信息。 |
| 通讯录管理 | get_parent_departments_by_user | 查询指定用户所属的所有父级部门。 |
| 通讯录管理 | get_department_user_base_info | 调用本接口获取指定部门的用户基础信息。 |
| 通讯录管理 | get_userid_by_unionid | 根据unionid获取用户的userid。 |
| 通讯录管理 | get_org_account_status | 查询某企业帐号的启用状态。 |
| 通讯录管理 | get_department_detail | 根据部门ID获取指定部门详情。 |
| 通讯录管理 | get_admin_scope | 调用本接口获取管理员通讯录权限范围。 |
| 通讯录管理 | get_admin_list | 调用本接口查询管理员列表。 |
| 通讯录管理 | get_employee_leave_records | 查询企业离职记录列表，包含离职员工的离职日期、手机号码和退出企业方式等信息。 |
| 通讯录管理 | get_parent_departments_by_dept | 获取指定部门的所有父部门ID列表。 |
| 通讯录管理 | get_department_user_userid_list | 调用本接口获取指定部门的userid列表。 |
| 通讯录管理 | get_migration_ding_id_by_ding_ids | 根据原dingId查询迁移后的dingId。 |
| 通讯录管理 | get_ding_id_by_migration_ding_id | 根据迁移后的dingId查询原dingId。 |
| 通讯录管理 | get_union_id_by_migration_union_ids | 根据迁移后的unionId查询原unionId。 |
| 通讯录管理 | get_user_detail | 调用本接口获取指定用户的详细信息。 |
| 通讯录管理 | get_user_by_mobile | 根据手机号查询用户，获取用户的userId。 |
| 通讯录管理 | set_department_visibility_priority | 设置通讯录部门可见性优先级。 |
| 通讯录管理 | get_migration_union_id_by_union_ids | 根据原unionId查询迁移后的unionId。 |
| 通讯录管理 | change_main_administrator | 将本组织内某企业账号有所有权的组织，转交给另一企业账号，如果接收的账号不在该组织内则自动加入。 |
| 通讯录管理 | update_department | 调用本接口更新部门信息。 |
| 通讯录管理 | update_contact_hide_settings | 新增或更新通讯录隐藏设置。 |
| 通讯录管理 | update_enterprise_account_user_info | 调用本接口更新指定的企业账号用户信息。 |
| 通讯录管理 | update_external_contact | 调用本接口，更新企业外部联系人。 |
| 通讯录管理 | set_senior_mode | 调用本接口设置员工的高管模式。 |
| 通讯录管理 | set_role_member_management_scope | 设定角色成员管理范围。 |
| 通讯录管理 | update_role_name | 调用本接口，更新角色名称。 |
| 通讯录管理 | create_user | 调用本接口创建新用户。 |
| 通讯录管理 | update_user_info | 调用本接口更新指定的用户信息。 |
| 通讯录管理 | get_owned_organizations | 查询企业帐号在哪些企业下拥有创建者身份，并获取这些企业信息。 |
| 即时通信IM | add_group_members | 新增群成员。 |
| 即时通信IM | send_work_notification | 调用本接口发送工作通知消息。 |
| 即时通信IM | batch_recall_robot_messages | 批量撤回人与机器人会话中机器人消息。 |
| 即时通信IM | batch_set_group_administrators | 批量设置企业群内用户为管理员身份或取消管理员身份。 |
| 即时通信IM | batch_recall_robot_messages | 调用本接口批量撤回人与人会话中机器人消息。 |
| 即时通信IM | batch_query_robot_message_read_status | 批量查询人与机器人会话中机器人消息是否已读。 |
| 即时通信IM | query_group_message_read_status | 查询企业机器人群聊消息用户已读状态。 |
| 即时通信IM | batch_send_robot_messages | 调用本接口批量发送人与机器人会话（人与机器人单聊）中机器人消息。 |
| 即时通信IM | clear_robot_shortcut | 清空单聊机器人快捷入口。 |
| 即时通信IM | close_interactive_card_header | 调用本接口关闭会话中的互动卡片吊顶。 |
| 即时通信IM | create_group | 根据群模板ID创建群。 |
| 即时通信IM | create_and_open_interactive_card | 创建并开启会话中的互动卡片吊顶。 |
| 即时通信IM | create_group | 创建内部群会话。 |
| 即时通信IM | deactivate_group_template | 根据群模板ID停用群模板。 |
| 即时通信IM | download_robot_message_file | 调用本接口下载机器人接收消息的文件内容。 |
| 即时通信IM | apply_group_template | 根据群模板ID启用群模板。 |
| 即时通信IM | recall_group_message | 企业机器人撤回内部群消息。 |
| 即时通信IM | get_work_notification_send_result | 查询工作通知消息的发送结果。 |
| 即时通信IM | update_group | 调用本接口更新群会话。 |
| 即时通信IM | recall_work_notification | 撤回工作通知消息。 |
| 即时通信IM | get_chat_info | 调用本接口获取群设置和成员信息。 |
| 即时通信IM | get_group_qrcode_link | 调用本接口，获取群入群二维码邀请链接。 |
| 即时通信IM | get_open_conversation_id | 通过chatId查询OpenConversationId。 |
| 即时通信IM | get_bot_list_in_group | 调用本接口获取群内机器人列表。 |
| 即时通信IM | get_message_send_progress | 获取工作通知消息的发送进度。 |
| 即时通信IM | get_group_info | 根据群ID查询群的信息。 |
| 即时通信IM | query_group_summary_info | 根据群ID查询群的简要信息。 |
| 即时通信IM | batch_query_group_members | 查询群成员信息。 |
| 即时通信IM | get_group_mute_status | 通过本接口查询群和群内成员的禁言状态。 |
| 即时通信IM | query_robot_message_read_list | 查询人与人会话中机器人消息已读列表。 |
| 即时通信IM | query_single_chat_robot_shortcut | 调用本接口查询单聊机器人的快捷入口。 |
| 即时通信IM | send_ding_message | 使用企业内机器人发送DING消息，支持应用内DING、短信DING、电话DING。 |
| 即时通信IM | recall_ding_message | 撤回使用企业机器人发送的DING消息。 |
| 即时通信IM | delete_group_members | 调用本接口删除群成员。 |
| 即时通信IM | update_group | 根据群ID更新群信息。 |
| 即时通信IM | query_group_template_robots | 调用本接口查询群内群模板机器人信息。 |
| 即时通信IM | send_group_assistant_message | 通过群模板定义的机器人向群内发送消息。 |
| 即时通信IM | update_group_member_nickname | 调用本接口更新群成员在群中的昵称。 |
| 即时通信IM | update_group_admin | 调用本接口更新群管理员。 |
| 即时通信IM | set_group_member_mute_status | 设置场景群内的群成员禁言状态，可设置指定群成员禁言或解除禁言。 |
| 即时通信IM | set_group_member_private_chat | 设置群成员之间是否可以添加好友和私聊。 |
| 即时通信IM | set_robot_shortcut | 调用本接口设置单聊机器人的快捷入口。 |
| 即时通信IM | send_group_message | 通过应用机器人发送群聊消息。 |
| 即时通信IM | send_private_chat_message | 调用本接口实现人与人会话中机器人发送普通消息。 |
| 即时通信IM | update_group_administrators | 更新群的群管理员。 |
| 即时通信IM | update_group_member_nick | 调用本接口更新场景群群成员的群昵称。 |
| 即时通信IM | update_work_notification_status_bar | 调用本接口，更新 OA 工作通知消息的状态。 |
注意事项
- 当前处于发布早期阶段，功能持续完善中
- 妥善保管私钥，防止泄露
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
