AI导哈

Todoist MCP服务

一个为AI代理设计的Todoist统一API v1的模型上下文协议（MCP）服务器，提供声明式工具注册、服务器端权限模型和高效率的负载处理。

  • by DevonGroff
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 DevonGroff/todoist-mcp

使用说明

****

  • **** (read / write / destructive)；配置模式之外的工具包括 从不 注册的，即使在跳过客户端权限的线束通道上也是如此 提示。 todoist_get_capabilities 审核活动表面（注册+过滤+为什么）。
  • 默认情况下，有效载荷很小。 Todoist对象包含25+个字段；仅返回苗条模式 与决策相关，并使用紧凑的JSON。示例：4个项目=约770B，而原始约6KB 印刷精美。 TODOIST_SLIM=0 恢复原始透传。
  • 可靠的评论很重要。 v1列表有效载荷 note_count 不可靠（报告0 带有注释的任务）；slim-list有效载荷删除它 todoist_get_task 返回a 权威的 comment_count 提取自 /comments.
  • 修复v1.x版本的缺陷。 todoist_search_tasks 现在荣誉 project_id/section_id/label （之前已被接受并忽略）； todoist_get_completed_stats 最多1000页 完成次数（之前默默地限制在200次）。
  • 新的v1曲面。 提醒、保存的筛选器（Sync-API通道-筛选器没有REST 资源，实时验证），活动日志(/activities)、备份、用户/计划信息， 生产率统计(/tasks/completed/stats), todoist_quick_add （自然语言）， 和 deadline_date 任务创建/更新（执行日期与终止日期的区别）。

配置

{
  "mcpServers": {
    "todoist": {
      "command": "node",
      "args": ["/path/to/todoist-mcp/dist/index.js"],
      "env": { "TODOIST_API_TOKEN": "${TODOIST_API_TOKEN}" }
    }
  }
}

环境旋钮（全部可选）：

变量 值 默认值 效果
TODOIST_TOOL_MODE full standard read-only
TODOIST_TOOLS_DENY 工具名称逗号列表 -- 强制关闭特定工具（胜过一切）。
TODOIST_TOOLS_ALLOW 工具名称逗号列表 -- 无论模式如何，强制特定工具打开（拒绝仍然获胜）。
TODOIST_SLIM 1 0 1

永远不要提交您的API令牌。

工具表面

51个工具已注册 standard 模式；9更多(delete_*, reopen_*)in full. 询问服务器本身：调用 todoist_get_capabilities 对于带有层级的实时列表。

组：任务（列表/获取/搜索/层次结构/重复·创建/更新/快速添加/完成/移动/ 跟进/带上下文·4批操作·删除+重新打开破坏层）、项目、部分、， 评论（包括。 [Research]/[Context] 助手）、标签、已完成+统计数据、工作区概述， 提醒、已保存的过滤器、活动日志、备份、用户。

优先级约定：API值从UI反转（P1紧急=4…P4未诊断=1）。

响应格式

每个工具都会返回 { success, data } 或 { success: false, error: { code, message, details? } } 作为单个紧凑的JSON文本块。

开发与测试

npm run build        # tsc
npm run typecheck
node smoke-test.mjs  # protocol-level live smoke: spawns dist/index.js over stdio,
                     # verifies mode filtering + live reads (needs TODOIST_API_TOKEN)

许可证

国际学生中心

相关 MCP