dingtalk_mcp_server

dingtalk_mcp_server 是钉钉开放接口对应的 MCP Server，让你可以使用大模型轻松操作钉钉。

前置条件

1. 在钉钉开发者后台创建企业内部应用。
2. 给应用调用所有接口的权限
3. 参考 .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 进行调试:

1. 启动Inspector： mcp dev src/main.py
2. 在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 工作通知消息的状态。

注意事项

• 当前处于发布早期阶段，功能持续完善中
• 妥善保管私钥，防止泄露