UNPKG

dingtalk-mcp

Version:

DingTalk MCP Server - A TypeScript-based MCP server for DingTalk integration

200 lines (197 loc) 5.98 kB
server: name: dingtalk-tasks description: 钉钉待办 default_active: false securitySchemes: - id: DingTalkAuth type: apiKey in: header name: x-acs-dingtalk-access-token tools: - name: queryTasks description: 查询钉钉待办/任务列表 args: - name: unionId description: 用户UnionId type: string required: true position: path - name: nextToken type: string description: 分页游标,默认为0。如果一个查询条件一次无法全部返回结果,会返回分页token,下次查询带上该token后会返回后续数据,直到分页token为null表示数据已经全部查询完毕。 position: body - name: isDone description: 待办完成状态。true:已完成;false:未完成 type: boolean position: body - name: roleTypes description: 查询目标用户角色类型。executor:执行人;creator:创建人;participant:参与人。可以同时传多个值。外层list表示或的关系,内层list表示与的关系。例如:[["executor"], ["creator"],["participant"]] 表示查询用户角色为执行人或创建人或参与人的待办列表; [["executor", "creator"]] 表示查询用户角色为执行人并且是创建人的待办列表。 type: array items: type: array items: type: string position: body requestTemplate: url: https://api.dingtalk.com/v1.0/todo/users/{unionId}/org/tasks/query method: POST headers: - key: Content-Type value: application/json security: id: DingTalkAuth responseTemplate: {} - name: deleteTask description: 删除钉钉待办 args: - name: unionId description: 用户UnionId type: string required: true position: path - name: taskId description: 待办ID type: string required: true position: path requestTemplate: url: https://api.dingtalk.com/v1.0/todo/users/{unionId}/tasks/{taskId} method: DELETE headers: - key: Content-Type value: application/json security: id: DingTalkAuth responseTemplate: {} - name: createTask description: 创建待办 args: - name: unionId description: 待办创建者的UnionId type: string required: true position: path - name: subject description: 待办标题,最大长度1024 type: string required: true position: body - name: description description: 待办备注,最大长度4096 type: string position: body - name: dueTime description: 待办截止时间,Unix时间戳,单位毫秒。 type: number position: body - name: executorIds description: 待办执行人的UnionId type: array position: body items: type: string - name: participantIds description: 待办参与人的UnionId type: array position: body items: type: string requestTemplate: url: https://api.dingtalk.com/v1.0/todo/users/{unionId}/tasks method: POST headers: - key: Content-Type value: application/json security: id: DingTalkAuth responseTemplate: { } - name: updateTask description: 更新待办 args: - name: unionId description: 用户UnionId type: string required: true position: path - name: taskId description: 待办ID type: string required: true position: path - name: subject description: 待办标题,最大长度1024 type: string required: true position: body - name: description description: 待办备注,4096 type: string position: body - name: done description: 完成状态。true:已完成;false:未完成 type: boolean position: body - name: dueTime description: 待办截止时间,Unix时间戳,单位毫秒。 type: number position: body - name: executorIds description: 待办执行人的UnionId type: array position: body items: type: string - name: participantIds description: 待办参与人的UnionId type: array position: body items: type: string requestTemplate: url: https://api.dingtalk.com/v1.0/todo/users/{unionId}/tasks/{taskId} method: PUT headers: - key: Content-Type value: application/json security: id: DingTalkAuth responseTemplate: { } - name: updateExecutorsTaskStatus description: 更新执行人待办状态 args: - name: unionId description: 待办所属用户UnionId type: string required: true position: path - name: taskId description: 待办ID type: string required: true position: path - name: executorStatusList description: 执行者状态列表,id需传用户的unionId,最大数量1000。 type: array required: true position: body items: type: object properties: id: type: string description: 执行者unionId isDone: type: boolean description: 执行者完成状态 "required": - "id" - "isDone" requestTemplate: url: https://api.dingtalk.com/v1.0/todo/users/{unionId}/tasks/{taskId}/executorStatus method: PUT headers: - key: Content-Type value: application/json security: id: DingTalkAuth responseTemplate: { }