TickTick / Dida365 (滴答清单)

通过 mcpdida* MCP 工具进行任务管理。无需打开应用即可跨所有清单查询、创建和更新任务。

可用工具: 查询任务、清单查询、任务管理

清单查询

工具	介绍	说明
listprojects	获取当前账号中的所有清单
getprojectbyid

根据清单 ID 获取指定清单的详细信息 | | | getprojectwithundonetasks | 获取指定清单详情，同时返回该清单下所有未完成的任务 | | | gettaskin_project | 获取指定清单中的某个特定任务 | |

查询任务

工具	介绍	说明
searchtask	使用关键词搜索任务，返回任务 ID、标题和链接等
gettaskbyid

根据任务 ID 获取任务的完整内容 | | | listundonetasksbytime_query | 查询一段时间的未完成任务，默认查询今天的未完成任务 | 支持选项：today, last24hour, last7day, tomorrow, next24hour, next7day | | listundonetasksbydate | 查询指定日期范围内的未完成任务 | 日期跨度最大 14 天 | | listcompletedtasksbydate | 查询指定清单中，在日期范围内的已完成的任务 | | | filter_tasks | 按日期、清单、优先级、标签、类型、状态等多条件组合查询任务 | |

任务管理

工具	介绍	说明
createtask	创建任务，支持设置标题、描述、日期、优先级、清单、标签等属性
batchadd_tasks

批量创建任务，并设置每个任务的各字段 | | | complete_task | 完成指定任务 | | | completetasksin_project | 批量完成指定清单中的多个任务 | 每次最多 20 个 | | update_task | 修改任务的标题、描述、日期、优先级等属性 | | | move_task | 将任务移动到其他清单 | | | batchupdatetasks | 批量修改多个任务的属性值 | |

常见工作流程

查看今日待办

mcpdidalistundonetasksbytime_query { queryCommand: today }

通过关键词查找任务

mcpdidasearch_task { query: 关键词 }

检查生产力/完成率

滴答清单的成就系统通过以下公式追踪你的完成率：
完成率 = 已完成任务 ÷ 原始计划任务

按时完成任务会增加成就点数，拖延则会减少。点数每天午夜更新。共有 12 个成就等级。

要计算某段时间的完成率：

1. 1. 获取已完成任务：

mcpdidalistcompletedtasksbydate {
completedTaskSearch: { projectIds: [], startDate: 2024-01-01, endDate: 2024-01-07 }
}

1. 2. 获取同一时间段的未完成任务：

mcpdidalistundonetasksbydate {
undoneTaskSearch: { projectIds: [], startDate: 2024-01-01, endDate: 2024-01-07 }
}

1. 3. 计算：已完成 / (已完成 + 未完成) — 这与滴答清单成就面板中显示的结果一致。

创建带有截止日期的任务

mcpdidacreate_task {
task: {
title: 买咖啡,
projectId: ,
dueDate: 2024-01-15T09:00:00+08:00,
priority: 1, // 0=无, 1=低, 3=中, 5=高
timeZone: Asia/Shanghai,
isAllDay: false,
status: 0,
...
}
}

对于没有实际意义的必填字段，请使用：assignor: , childIds: [], columnId: , columnName: , completedTime: , content: , desc: , etag: , id: , items: [], kind: , parentId: , reminders: [], repeatFlag: , sortOrder: 0, startDate: , tags: []。

完成任务

mcpdidacomplete_task { projectId: , taskId: }

筛选本周到期的高优先级任务

mcpdidafilter_tasks {
taskFilterDto: {
startDate: 2024-01-15,
endDate: 2024-01-21,
priority: [5],
status: [0],
projectIds: [],
kind: [],
tag: []
}
}

优先级级别

值	含义
0	无优先级
1

低 | | 3 | 中 | | 5 | 高 |

任务状态

值	含义
0	未完成
2

已完成 |

提示

• - projectIds: [] 在筛选/日期查询中表示所有清单
• 共享清单中的任务按用户视角显示 — 分配给其他人的任务不会影响你的成就分数
• dueDate 和 startDate 使用带时区的 ISO 8601 格式，例如 2024-03-15T10:00:00+08:00
• listundonetasksbydate 的日期范围每次调用上限为 14 天