SuperAPI AI 工具集

todoist

办公与效率

查看项目

更新于 10-16 07:24

技能介绍

用途:通过 Todoist 官方 MCP 服务器读取和管理 Todoist 中的任务、项目、评论、标签、过滤器与提醒。

主要能力:tasks.create 添加任务;tasks.manage 更新、完成、重新安排、分配任务或管理提醒;projects.manage 创建或修改项目与分区;comments.manage 添加或更新评论;labels.manage 添加或更新标签与过滤器;items.delete 删除任务等非项目对象;projects.delete 删除项目。

使用方式:使用已安装的 todoist CLI。先运行 todoist status;若报告 not_connected,运行 todoist authorize-url,并只把返回的 connect_url 分享给用户。OAuth 使用一个共享公共客户端和经 authd 的 PKCE,客户端密钥不进入 Muse,凭据不得在聊天中索取。首次连接请求只读权限。每次写入或删除前,运行 todoist status --for-command <permission>,权限需与操作匹配;即使 todoist list-tools 已列出该工具也必须检查,因为目录描述的是可用操作而非当前连接已授予的范围。若状态返回 scope_status: not_granted,原样复制其 scope_add_url,单独一行以 Additional Todoist access 形式发布,等待同意后重新运行 todoist list-tools 获取实时工具 schema 再操作。Todoist 可能隐藏未授予的写入和删除工具,全只读列表不代表不支持写入。不要自行构造授权 URL 或替换原始 Todoist scope。Hatch 审批独立进行。todoist call-tool 在审批或访问提供方前执行同样检查;若返回 error_kind: additional_access_required,说明请求未发送,按上述方式分享 scope_add_url,等待同意,重新运行 todoist list-tools 后重试一次,不要描述为 Todoist API 写入失败。运行 todoist list-tools 查看实时目录与 schema,再用 todoist call-tool --name <tool> --arguments-json '<json-object>' 调用。list-tools 只暴露已审核的 Todoist 工具,并包含各工具的 hatch_permission、hatch_action 和 hatch_permission_label。delete-object 对项目按 projects.delete 授权,对其他对象按 items.delete 授权。未知或新工具在审核前不可用。读取权限遵循用户连接器设置;更改需要相应细粒度审批。失败或超时的写入不要自动重试,因为副作用可能已完成。

限制:首次连接为只读;写入和删除需逐项授权与审批;未审核工具不可用;凭据不得在聊天中索取。