用途:通过 Todoist REST API v1 的 Python 脚本对 Todoist 进行 CRUD 操作,适用于用户提到 Todoist 或待办清单时。
主要能力:资源涵盖 tasks、projects、sections、labels、comments、reminders。脚本调用格式为 python3 "${CLAUDE_SKILL_DIR}/scripts/todoist.py" <resource> <action> [args...],成功输出 JSON,错误输出 HTTP <code> 到 stderr 并非零退出。可添加任务(支持 --due、--priority、--labels、--project-id)、按过滤条件列出任务(如 today、overdue、7 days、p1、@label、#Project)、完成任务、更新截止日期或标题、增改项目和标签等。
认证:Token 存于 ${CLAUDE_SKILL_DIR}/.apikey(权限 600),或使用 TODOIST_API_TOKEN 环境变量(优先)。令牌错误(401/403)需在 Todoist 设置中重新生成。
使用要点:Todoist 使用数字 ID,建议先 list 资源再按名称匹配 ID 后操作。完成优于删除(保留历史),删除不可逆需先确认。DELETE 为软删除。速率限制约每 15 分钟 450 次请求,批量读取宜用 tasks list --ids。references 目录下还有 API 参考、过滤器系统与提醒等按需文档。
限制:deadline 日期与提醒写入属 Premium 功能,Free 会返回 403 PREMIUM_ONLY,不要调用;Free 可用 --due "YYYY-MM-DD HH:MM" 或另建准备任务替代。--due 仅支持英文自然语言或 YYYY-MM-DD,中文相对日期需自行换算。具体价格与完整功能细节资料未提供。