# DingTalk MCP for AI Agents AI Agent Connect > DingTalk MCP connects your Alibaba enterprise account to your AI client. It lets you manage office operations like user lookups, sending markdown notifications, tracking employee attendance, and handling approval workflows through a simple conversation. It turns your AI into a dedicated office operations assistant. ## Overview - **Category:** industry-titans - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_quQNZfrAjxwpdEp0StBqRkWjLRgtdEFujJGWMBVj/ai-agent-connect - **Tags:** enterprise-messaging, workflow-automation, attendance-tracking, b2b-operations, task-management, notifications ## Description Managing a large organization usually means jumping between tabs to find out who reported for work, where a specific department sits in the hierarchy, or why a reimbursement request is stuck in limbo. This Connector changes that by bringing those DingTalk operations directly into your chat interface. Instead of digging through menus, you just ask your AI client to pull up a team roster or check if a specific manager signed off on a purchase. It handles the heavy lifting of navigating organizational structures and broadcasting formatted updates to the right people. You'll find it's a huge time-saver for routine tasks like sending out markdown-formatted reports or pulling attendance data for the week. Because Vinkius hosts this connection, you can get your enterprise account hooked up and start offloading these repetitive admin tasks to your agent immediately. It's about getting answers and completing actions without ever having to open the DingTalk app yourself. ## Tools ### create_approval_process Create a new approval instance for things like leave requests or reimbursements. This lets you start workflows through a chat. ### get_approval_instance Check the current status of an approval process. Use this to see if a request is pending, approved, or rejected. ### get_attendance_records Pull timestamps and location data for employee check-ins. It helps you verify timesheets and spot late arrivals. ### get_department_info Get details on a specific department's hierarchy. Use this to understand reporting lines before sending messages. ### get_user_info Pull a user's profile details using their ID. This is great for looking up specific employee info before reaching out. ### list_all_departments See every top-level department in the organization. It's the quickest way to map out the whole company structure. ### list_sub_departments Find all the smaller teams under a specific department. Start with the main department ID to see the full tree. ### list_users_by_department Get a list of names and avatars for everyone in a department. Use this to see who's on a team before sending group pings. ### send_markdown_message Send messages with bold text, links, and headers. This is perfect for sending out polished reports or alerts. ### send_work_notification Send a direct alert to a user's notification feed. It's the best way to send quick reminders or task assignments. ## Prompt Examples **Prompt:** ``` Who is in the Engineering department? ``` **Response:** ``` 📋 I found 8 users in the Engineering department: * **Zhang Wei** (Engineering Lead) * **Li Na** (Senior Developer) * **Wang Fang** (Developer) * **Chen Ming** (QA Engineer) * **Liu Yang** (Designer) * **Zhao Lei** (Product Manager) * **Sun Li** (Business Analyst) * **Zhou Tao** (DevOps) Would you like to see the profile for any of these people? ``` **Prompt:** ``` Send a markdown alert to the HR team about the new policy. ``` **Response:** ``` ✅ Markdown notification sent! **Title:** New Policy Update **Content:** Please review the updated remote work guidelines attached in the company handbook. The message has been delivered to the HR team feed with clickable links for the handbook. ``` **Prompt:** ``` Show me the attendance records for user1 from last Tuesday. ``` **Response:** ``` 📊 **Attendance Report (2024-01-16):** * **User1:** Check-in 08:55, Check-out 18:02 * **Status:** Normal Everything looks standard for that day. Do you want me to check any other dates? ``` ## Capabilities ### Pull employee profiles Get specific user details and contact information instantly. ### Map out company hierarchy Navigate departments and sub-departments to understand reporting lines. ### Send rich-text notifications Broadcast formatted alerts and reports with links and bold text. ### Track employee check-ins Retrieve timestamps and location data for attendance monitoring. ### Create and monitor approvals Start new leave requests or purchase orders and track their progress. ## Use Cases ### Checking morning attendance An HR manager asks the agent to check who was late today. The agent pulls records using get_attendance_records and summarizes the list. ### Sending a formatted report A project lead asks the agent to send a markdown summary of the weekly goals. The agent uses send_markdown_message to ping the team. ### Starting a reimbursement request An employee asks to start a purchase order. The agent uses create_approval_process to initiate the workflow with the correct details. ### Finding team members A new manager needs to know who's in the Marketing department. The agent uses list_users_by_department to provide a full roster. ## Benefits - Stop manual lookups: Use list_users_by_department to find team members instantly instead of searching through a directory. - Automate approvals: Create leave requests or purchase orders with create_approval_process without leaving your chat. - Faster reporting: Send formatted summaries using send_markdown_message to keep everyone on the same page. - Accurate tracking: Monitor check-ins and late arrivals with get_attendance_records to keep HR data clean. - Clearer hierarchy: Map out the whole company structure with list_all_departments to ensure messages go to the right place. ## How It Works The bottom line is you get a conversational interface for all your heavy-duty DingTalk admin tasks. 1. Subscribe to the DingTalk MCP on Vinkius. 2. Enter your DingTalk App Key and App Secret from your enterprise account. 3. Ask your AI client to perform tasks like sending a notification or checking attendance. ## Frequently Asked Questions **What can I do with the DingTalk MCP?** You can manage your entire office workflow through your AI client. This includes pulling user profiles, mapping out your company's department structure, sending rich notifications, and tracking employee attendance. **How does DingTalk MCP help with HR tasks?** It automates the tedious parts of HR. You can quickly verify timesheets, monitor late arrivals, and send out policy announcements to the whole team without leaving your chat interface. **Can I send formatted messages to my team?** Yes, you can send notifications that include bold text, italics, and clickable links. This makes it much easier to share polished reports and important alerts clearly. **Can DingTalk MCP handle company approvals?** It can. You can create new approval instances for things like leave requests or purchase orders and then check their status to see if they've been approved or rejected. **How do I set up DingTalk MCP for my office?** Once you subscribe on Vinkius, you just need to provide your DingTalk App Key and App Secret. From there, your AI client can start performing actions on your behalf. **Is this good for large organizations?** It's built for enterprise use. It helps large companies navigate complex reporting lines and handle high-volume notifications and approvals through a single conversational point. **How do I get my DingTalk App Key and App Secret?** Log in to the [DingTalk Developer Console](https://open-dev.dingtalk.com/), create an **Internal Enterprise Application**, then navigate to **App Information** > **Credentials** to find your AppKey and AppSecret. Make sure your application has the required API permissions (User Management, Department Management, Attendance, Approval) before using these tools. **Can I send messages to external contacts or only internal employees?** This Connector uses **Internal Enterprise Application** authentication, which means it can only send messages to users within your organization's DingTalk tenant. For external contacts or customer notifications, you would need a different DingTalk application type with extended permissions. All user IDs must belong to employees in your enterprise directory. **How does the attendance tracking work? What data can I retrieve?** The attendance tool retrieves check-in/check-out records from DingTalk's attendance system. For each record, you get the user ID, timestamp, checkout type (上班签到=check-in, 下班签退=check-out), location information, and whether the attendance was normal or abnormal (late, early leave, missing punch). Date ranges are specified in YYYY-MM-DD format. This data integrates with DingTalk's physical attendance devices and mobile check-in features.