关键词

Todoist任务管理智能任务助理自然语言接口效率工具项目自动化

项目简介

'mcp-todoist' 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在让大型语言模型 (LLM) 能够与 Todoist 任务管理平台无缝集成。它通过提供一系列工具，允许用户使用自然语言对 Todoist 中的任务、项目、标签和评论进行创建、读取、更新、删除及其他高级操作，从而将 LLM 转化为一个强大的个人效率助手。

主要功能点

  • 全面的任务管理: 支持任务的创建、读取、更新、删除和完成，包括设置描述、截止日期、优先级和标签等所有属性。
  • 分层子任务支持: 创建子任务，将现有任务转换为子任务，提升子任务为独立任务，并提供带有完成进度跟踪的任务层级视图。
  • 高效的批量操作: 允许一次性创建、更新、删除或完成多个任务，大大提高操作效率。
  • 灵活的评论系统: 为任务添加评论，支持文本内容和可选的文件附件，并可按任务或项目检索所有相关评论。
  • 完整的标签管理: 对 Todoist 标签进行完整的创建、读取、更新、删除操作，并提供详细的标签使用统计报告。
  • 项目与分区组织: 轻松创建和管理 Todoist 中的项目和分区，帮助您更好地组织工作。
  • 干运行模式 (Dry-Run Mode): 提供一个安全的环境，让您在不实际修改 Todoist 数据的情况下测试自动化和操作，非常适合验证复杂指令或调试。
  • 自然语言接口: 告别繁琐的点击，使用日常对话即可管理您的 Todoist 工作区，提升用户体验。

安装步骤

  1. 获取您的 Todoist API Token:

    • 登录您的 Todoist 账户。
    • 前往 设置 → 集成。
    • 向下滚动到 开发者 部分。
    • 复制您的 API Token（请务必妥善保管此 Token，不要泄露）。

  2. 安装 MCP 服务器 (推荐使用 npx，无需全局安装): 这是最简便的方法，您无需提前全局安装 '@greirson/mcp-todoist' 包。如果您偏好全局安装，可以运行 'npm install -g @greirson/mcp-todoist'。

服务器配置 (以 Claude Desktop 客户端为例)

MCP 服务器的配置通常在您的 MCP 客户端（如 Claude Desktop）的配置文件中进行。以下是配置 'mcp-todoist' 服务器的 JSON 格式示例：

// 文件路径示例 (macOS/Linux): ~/.config/claude_desktop_config.json
// 文件路径示例 (Windows): %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "todoist": { // 这是 MCP 服务器的名称，您可以自定义
      "command": "npx", // 用于启动服务器的命令，如果全局安装 '@greirson/mcp-todoist'，则这里是 "mcp-todoist"
      "args": ["@greirson/mcp-todoist"], // 传递给命令的参数，如果全局安装，则无需此项
      "env": {
        "TODOIST_API_TOKEN": "您的Todoist_API_Token", // 替换为您的实际 Todoist API Token
        "DRYRUN": "false" // 可选，设置为 "true" 启用干运行模式，所有修改操作将只模拟不实际执行
      }
    }
  }
}

重要提示: 请务必将 '您的Todoist_API_Token' 替换为您在第一步中获取的实际 Todoist API Token。 配置完成后，请关闭并重新启动您的 Claude Desktop 客户端以加载新的 MCP 服务器。

基本使用方法

在成功配置并重启您的 MCP 客户端后，您可以直接向 LLM 提问或发出指令来管理 Todoist。LLM 将会自动调用 'mcp-todoist' 服务器提供的工具来执行您的请求。

  • 测试连接: "测试我的 Todoist 连接"
  • 查看项目: "显示我所有的 Todoist 项目"
  • 创建任务: "在我的 '工作任务' 项目中创建一个名为 '提交月报' 的高优先级任务，截止日期是下周五"
  • 添加带标签的任务: "添加任务 '回顾PR'，截止日期是明天，并标记为 ['代码审查', '紧急']"
  • 更新任务: "将任务 '回顾PR' 的内容更新为 '审查PR并合并'，并将其优先级设为正常"
  • 完成任务: "完成任务 ID 为 1234567890 的任务"
  • 创建子任务: "在任务 '项目启动会议' 下创建一个子任务 '准备会议议程'"
  • 批量创建任务: "为项目启动创建多个任务: '设计原型', '编写文档', '设置CI/CD'"
  • 查看标签统计: "获取所有 Todoist 标签的使用统计"

信息

分类

生产力应用

访问项目