dida365
# TickTick / Dida365 (滴答清单)
Task management via the `mcp__dida__*` MCP tools. Query, create, and update tasks across all projects — no app required.
**可用工具:** 查询任务、清单查询、任务管理
## 清单查询
| 工具 | 介绍 | 说明 |
|------|------|------|
| `list_projects` | 获取当前账号中的所有清单 | |
| `get_project_by_id` | 根据清单 ID 获取指定清单的详细信息 | |
| `get_project_with_undone_tasks` | 获取指定清单详情，同时返回该清单下所有未完成的任务 | |
| `get_task_in_project` | 获取指定清单中的某个特定任务 | |
## 查询任务
| 工具 | 介绍 | 说明 |
|------|------|------|
| `search_task` | 使用关键词搜索任务，返回任务 ID、标题和链接等 | |
| `get_task_by_id` | 根据任务 ID 获取任务的完整内容 | |
| `list_undone_tasks_by_time_query` | 查询一段时间的未完成任务，默认查询今天的未完成任务 | 支持选项：`today`, `last24hour`, `last7day`, `tomorrow`, `next24hour`, `next7day` |
| `list_undone_tasks_by_date` | 查询指定日期范围内的未完成任务 | 日期跨度最大 14 天 |
| `list_completed_tasks_by_date` | 查询指定清单中，在日期范围内的已完成的任务 | |
| `filter_tasks` | 按日期、清单、优先级、标签、类型、状态等多条件组合查询任务 | |
## 任务管理
| 工具 | 介绍 | 说明 |
|------|------|------|
| `create_task` | 创建任务，支持设置标题、描述、日期、优先级、清单、标签等属性 | |
| `batch_add_tasks` | 批量创建任务，并设置每个任务的各字段 | |
| `complete_task` | 完成指定任务 | |
| `complete_tasks_in_project` | 批量完成指定清单中的多个任务 | 每次最多 20 个 |
| `update_task` | 修改任务的标题、描述、日期、优先级等属性 | |
| `move_task` | 将任务移动到其他清单 | |
| `batch_update_tasks` | 批量修改多个任务的属性值 | |
## Common Workflows
### See what's on today's plate
```
mcp__dida__list_undone_tasks_by_time_query { queryCommand: "today" }
```
### Find a task by keyword
```
mcp__dida__search_task { query: "关键词" }
```
### Check productivity / completion rate
Dida365's achievement system tracks your completion rate as:
**completion rate = completed tasks ÷ originally scheduled tasks**
Achievement points increase when you finish tasks on time and decrease with procrastination. Points update daily at midnight. There are 12 achievement levels.
To compute your completion rate for a period:
1. Get completed tasks:
```
mcp__dida__list_completed_tasks_by_date {
completedTaskSearch: { projectIds: [], startDate: "2024-01-01", endDate: "2024-01-07" }
}
```
2. Get undone tasks for the same range:
```
mcp__dida__list_undone_tasks_by_date {
undoneTaskSearch: { projectIds: [], startDate: "2024-01-01", endDate: "2024-01-07" }
}
```
3. Compute: `completed / (completed + undone)` — this mirrors what Dida365 shows in the achievement panel.
### Create a task with a due date
```
mcp__dida__create_task {
task: {
title: "买咖啡",
projectId: "<project-id>",
dueDate: "2024-01-15T09:00:00+08:00",
priority: 1, // 0=none, 1=low, 3=medium, 5=high
timeZone: "Asia/Shanghai",
isAllDay: false,
status: 0,
...
}
}
```
> For required fields with no meaningful value, use: `assignor: ""`, `childIds: []`, `columnId: ""`, `columnName: ""`, `completedTime: ""`, `content: ""`, `desc: ""`, `etag: ""`, `id: ""`, `items: []`, `kind: ""`, `parentId: ""`, `reminders: []`, `repeatFlag: ""`, `sortOrder: 0`, `startDate: ""`, `tags: []`.
### Complete a task
```
mcp__dida__complete_task { projectId: "<id>", taskId: "<id>" }
```
### Filter high-priority tasks due this week
```
mcp__dida__filter_tasks {
taskFilterDto: {
startDate: "2024-01-15",
endDate: "2024-01-21",
priority: [5],
status: [0],
projectIds: [],
kind: [],
tag: []
}
}
```
## Priority Levels
| Value | Meaning |
|-------|---------|
| 0 | No priority |
| 1 | Low |
| 3 | Medium |
| 5 | High |
## Task Status
| Value | Meaning |
|-------|---------|
| 0 | Undone |
| 2 | Completed |
## Tips
- **projectIds: []** means "all projects" in filter/date queries
- Tasks in shared lists have a per-user view — tasks assigned to others don't affect your achievement score
- `dueDate` and `startDate` use ISO 8601 with timezone, e.g. `"2024-03-15T10:00:00+08:00"`
- Date range for `list_undone_tasks_by_date` is capped at **14 days** per call
标签
skill
ai
