todoist-v1-mcp-server 是一个干净、可靠的 MCP 服务器，专为 Todoist 打造，基于当前的 Todoist 统一 API v1（而非已弃用的 v2）。它解决了一个常见痛点：官方 Todoist Web MCP 在 Anthropic 侧存在已知的持续断连 bug，需要每天重新连接；而社区替代方案要么基于已弃用的 REST API v2，要么存在模式验证 bug，导致 Todoist API 演进并返回额外字段时失败。
主要特点：面向当前 Todoist API v1；使用 stdio 传输，无云依赖，无需每日重连；使用现代 MCP SDK 的 registerTool() API（而非已弃用的 setRequestHandler 模式）；从不对 API 响应强制执行严格的输出模式，因此 Todoist 可以自由添加新字段而不会破坏任何内容；零 SDK 封装依赖，通过 axios 直接进行 HTTP 调用，避免中间库与 API 脱节。
工具集：共 31 个工具，涵盖任务、项目、分区、标签、评论、提醒等。提醒和已完成任务查询需要 Todoist Pro 订阅。如果 API 返回 Pro 门控错误（HTTP 402，或带有 premium / pro / upgrade / paid / subscription 等关键词的 403），服务器会返回一条清晰的消息，说明该功能需要 Pro，而不是泄露原始 API 错误。
使用方式：首先获取 Todoist API 令牌（设置 → 集成 → 开发者）；然后安装并构建；接着配置 Claude Desktop（编辑 claude_desktop_config.json 并重启）；也可选配置 Claude Code。连接后，Claude 可以处理自然语言指令，例如“今天有什么安排？”（使用 todoist_get_tasks 并带 filter: "today"）、“下周二提醒我打电话给牙医”（使用 todoist_create_task）、“把牙医任务标记为完成”（使用 todoist_complete_task）、“显示所有逾期任务”（使用 todoist_get_tasks 并带 filter: "overdue"）、“创建一个名为‘家庭装修’的项目”（使用 todoist_create_project）、“我有哪些项目？”（使用 todoist_get_projects）。todoist_get_tasks 的 filter 参数支持 Todoist 完整的自然语言过滤语法。
适用场景：希望通过 AI 助手以自然语言管理 Todoist 任务和项目的用户，尤其是需要稳定连接、避免每日重连的 MCP 集成场景。
限制：需要 Todoist 账户（免费层可用）；提醒和已完成任务查询需要 Todoist Pro 订阅。具体安装命令和配置细节请参考项目仓库。