核心用法
Todoist 技能通过 Maton 网关代理访问官方 Todoist API v1，提供完整的任务管理功能栈：
任务管理：创建、更新、完成（close）、重新打开（reopen）和删除任务，支持自然语言日期（"tomorrow at 5pm"）、优先级（1-4 级）、标签和子任务嵌套。
项目管理：创建、更新、删除项目，支持看板/列表视图切换、颜色标记和父子项目嵌套。
组织架构：通过 Sections（分区）在项目中创建阶段看板，通过 Labels（标签）实现跨项目分类。
协作功能：为任务或项目添加评论，支持团队协作者查询。
连接管理：OAuth 授权托管于 ctrl.maton.ai，支持多账户切换（通过 Maton-Connection 头），默认使用最早创建的活跃连接。
显著优点
- 托管 OAuth：无需自行处理 OAuth 流程，Maton 自动处理令牌刷新和存储
- 完整功能覆盖：涵盖 Todoist 官方 API 的所有核心实体（任务、项目、分区、标签、评论）
- 自然语言日期：
due_string支持 "every week"、"next Monday 3pm" 等表达式 - 多语言 SDK 示例：提供 Python、JavaScript、Bash 等即用代码片段
- 多账户支持：通过 Connection ID 可在同一技能下切换多个 Todoist 账户
潜在缺点与局限性
- 网关依赖：所有请求必须通过 Maton 网关（
gateway.maton.ai），无法直连 Todoist API - 速率限制透明性：429 错误直接透传自 Todoist，无额外缓冲或队列机制
- 环境变量要求：
MATON_API_KEY必须显式设置，curl 管道至 jq 时可能存在变量展开问题 - 无 Webhook 支持：文档未提及实时同步机制，需轮询获取更新
- 商业限制：免费版 Todoist 用户可能受限于项目数、协作者数等配额
适合人群
- 需要将 AI 工作流与任务管理集成的开发者
- 使用 Python/JavaScript 自动化任务批处理的技术用户
- 跨多个 Todoist 账户管理的团队管理员
- 追求"代码即配置"、反感手动 GUI 操作的高级用户
常规风险
- 令牌泄露：
MATON_API_KEY若泄露，攻击者可访问所有托管连接（包括 Todoist 数据） - 误删操作：DELETE 请求返回 204 无内容，无二次确认机制
- 数据一致性：网关层可能引入延迟，极端情况下存在与官方 Todoist 状态不一致的窗口期
- 供应商锁定：深度集成 Maton 网关后，迁移至其他代理方案需重写端点 URL 和认证逻辑