Todoist - Todoist 任务管理工具

---
name: todoist
description: 在 Todoist 中管理任务和项目。当用户询问任务、待办事项、提醒或生产力相关内容时使用。
homepage: https://todoist.com
metadata:
  clawdbot:
    emoji: "✅"
    requires:
      bins: ["todoist"]
      env: ["TODOIST_API_TOKEN"]
# Todoist CLI
Todoist 任务管理的 CLI，基于官方 TypeScript SDK 构建。
安装

bash # 需要 todoist-ts-cli >= 0.2.0（支持 --top / --order） npm install -g todoist-ts-cli@^0.2.0 --registry=https://registry.npmmirror.com

设置
前往 https://todoist.com/app/settings/integrations/developer 获取 API Token
任选其一：
   

bash todoist auth # 或 export TODOIST_API_TOKEN="your-token"

命令
任务

bash todoist # 显示今天的任务（默认） todoist today # 同上 todoist tasks # 列出任务（包括今天和逾期） todoist tasks --all # 列出所有任务 todoist tasks -p "Work" # 指定项目的任务 todoist tasks -f "p1" # 过滤查询（优先级 1） todoist tasks --json

添加任务

bash todoist add "Buy groceries" todoist add "Meeting" --due "tomorrow 10am" todoist add "Review PR" --due "today" --priority 1 --project "Work" todoist add "Prep slides" --project "Work" --order 3 # 在指定位置（基于 1）添加 todoist add "Triage inbox" --project "Work" --order top # 添加到顶部（等同于 --top） todoist add "Call mom" -d "sunday" -l "family" # 添加标签

管理任务

bash todoist view # 查看任务详情 todoist done # 完成任务 todoist reopen # 重新打开已完成任务 todoist update --due "next week" todoist move -p "Personal" todoist delete

搜索

bash todoist search "meeting"

项目与标签

bash todoist projects # 列出项目 todoist project-add "New Project" todoist labels # 列出标签 todoist label-add "urgent"

评论

bash todoist comments todoist comment "Note about this task"

使用示例
用户: "今天有什么待办？"

bash todoist today

用户: "把‘买牛奶’加到我的任务中"

bash todoist add "Buy milk" --due "today"

用户: "提醒我明天给牙医打电话"

bash todoist add "Call the dentist" --due "tomorrow"

用户: "把购物任务标记为完成"

bash todoist search "grocery" # 查找任务 ID todoist done

用户: "我的工作项目里有什么？"

bash todoist tasks -p "Work"

用户: "显示我的高优先级任务"

bash todoist tasks -f "p1"

过滤语法
Todoist 支持强大的过滤查询：
p1, p2, p3, p4 - 优先级等级
today, tomorrow, overdue
@label - 带有特定标签的任务
#project - 指定项目的任务
search: keyword - 搜索关键字
注意事项
任务列表中会显示任务 ID
截止日期支持自然语言（如 "tomorrow", "next monday", "jan 15"）
优先级 1 为最高，4 为最低
使用 --order （基于 1）或 --order top 将任务插入到项目/分区的指定位置