Use DingTalk with your AI.
Connect your account once and let the AI you already use work with it, without building another integration. Alibaba's B2B office platform. manage users, departments, send notifications, track attendance, and automate approval workflows.
Developed, maintained, and hosted by Vinkius.
MCP VERIFIED · PRODUCTION READY · VINKIUS GUARANTEED
Waiting for input…
Works with modern AI clients that support MCP, including ChatGPT, Claude, Cursor, and more.
Complete set · 10 capabilities
The complete DingTalk capability set.
These are the exact actions your AI can choose when you ask it to work with DingTalk.
01-04
4 capabilities in this set.
Part of 10 available through DingTalk.
- 01
Get department info
Use this to understand organizational hierarchy, identify department leaders, or map the reporting structure before making decisions about notification routing. Get detailed information about a DingTalk department
- 02
Get user info
Use the user ID (userid) which can be obtained from the department user list. Essential for looking up employee details before sending targeted notifications or checking organizational structure. Get DingTalk user profile information by user ID
- 03
List all departments
This is the fastest way to understand the organizational structure, identify department IDs for further queries, and map team hierarchies. Use this before querying users or sub-departments to identify the correct department IDs. List all top-level departments in the DingTalk organization
- 04
List sub departments
Essential for exploring organizational structure, identifying team subdivisions, or mapping the complete departmental hierarchy. Start with department_id 1 to list all top-level departments in your organization. List all sub-departments under a parent department
05-07
3 capabilities in this set.
Part of 10 available through DingTalk.
- 05
List users by department
Returns user IDs, names, avatars, and basic profile information. Useful for identifying team members before sending group notifications, checking team composition, or understanding departmental structure. Use department ID 1 for the root company directory. List all users in a specific DingTalk department
- 06
Create approval process
G., leave request, reimbursement, purchase order) by creating a new approval instance. Requires the approval template code (process_code) from your DingTalk admin, form component values matching the template structure, and the originator's user ID. Returns the process instance ID for tracking. Use this to automate approval workflows directly from AI conversations. Create a new approval workflow instance in DingTalk
- 07
Get approval instance
Returns whether the approval is pending, approved, rejected, or cancelled, along with all reviewer actions and timestamps. Use the process instance ID obtained when creating the approval or from the approval list. Critical for tracking approval progress and understanding bottlenecks. Get status and details of an approval process instance
08-10
3 capabilities in this set.
Part of 10 available through DingTalk.
- 08
Get attendance records
Returns timestamps, checkout types (上班签到/下班签退), location data, and whether the attendance was normal or abnormal (late/early leave). Essential for HR teams to monitor attendance patterns, verify timesheet data, or investigate attendance discrepancies. Date format: YYYY-MM-DD. Get employee attendance/checkout records from DingTalk
- 09
Send markdown message
Ideal for sending structured reports, formatted alerts, or detailed notifications with clickable links. The title appears as the notification header, while the text body supports full markdown syntax including bold, italic, hyperlinks, and line breaks. User IDs should be comma-separated. Send a rich formatted markdown message to DingTalk users
- 10
Send work notification
Supports text and markdown message types. The message appears in the recipient's DingTalk work notification feed. User IDs should be comma-separated for multiple recipients. This is ideal for sending alerts, reminders, task assignments, or status updates to team members directly through DingTalk. Send a work notification message to DingTalk users
Observed, not estimated
919ms average. Fast in production.
DingTalk is checked daily against the live service.
- Fastest day
- 740ms
- Slowest day
- 1138ms
- 14-day trend
- Slowing+15%
Connect your client
One URL. Every client.
Activate the Connector, copy your link, and paste it into the client you already use. 10 capabilities arrive ready to run.
Preview access · not provider authentication
The vk_preview_* token belongs to Vinkius preview infrastructure. It lets Claude discover and display the capabilities of DingTalk, so you can see the experience inside your AI.
It does not authenticate your account with DingTalk. Actions requiring credentials or live account data may not run until you activate the Connector and authorize the service.
DingTalk Connector
You're all set. Choose your MCP client and follow the setup instructions.
https://edge.vinkius.com/vk_preview_quQNZfrAjxwpdEp0StBqRkWjLRgtdEFujJGWMBVj/mcpClaude Desktop
Follow the steps below to connect in seconds.
- 1In Claude Desktop, open Settings → Connectors.
- 2Click “Add custom connector” and paste the connector link above as the remote MCP server URL.
- 3Click Add and start a new chat — DingTalk capabilities are ready to use.
{
"mcpServers": {
"dingtalk-mcp": {
"url": "https://edge.vinkius.com/vk_preview_quQNZfrAjxwpdEp0StBqRkWjLRgtdEFujJGWMBVj/mcp"
}
}
}
Claude
ChatGPT
Cursor
VS Code
Windsurf
Claude Code
JetBrains
Cline
Step-by-step instructions for each client are in the guide. How to connect
FAQ
Questions DingTalk owners ask.
- 01
How do I get my DingTalk App Key and App Secret?
Log in to the DingTalk Developer Console, 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 capabilities.
- 02
Can I send messages to external contacts or only internal employees?
This MCP server 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.
- 03
How does the attendance tracking work? What data can I retrieve?
The attendance capability 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.
Explore
More in Industry Titans
Courier AI Connector
Equip your AI agent to send multi-channel notifications and monitor delivery status through the Courier API.
ViewRange AI Connector
Keep distributed teams in sync with async check-ins, team updates, and meeting tools that reduce unnecessary s
ViewConcord (Workflow Orchestration) AI Connector
Enable your AI agent to manage CI/CD processes, inspect execution logs, and list organizations in your self-ho
ViewFiles.com AI Connector
Sync, share, and automate file workflows across teams with secure cloud storage that integrates with your exis
View
Suggestions
ThinkingData / 数数科技 AI Connector
Dominant games and app analytics platform — query events, audit users, and track data via AI.
ViewDialog Insight AI Connector
Equip your AI agent to manage marketing contacts, track campaigns, and monitor engagement via the Dialog Insig
ViewDixa AI Connector
Route customer conversations to the right agent across phone, email, chat, and messaging with intelligent prio
ViewFreshdesk AI Connector
Resolve customer tickets faster with omnichannel helpdesk tools, smart automation, and self-service portals yo
View
