Todoist Mcp Server

Todoist MCP Server

一个将 Todoist API 与 Claude 等 AI 助手连接起来的 Model Context Protocol（MCP）服务。该服务使 AI 助手能够与您的 Todoist 项目、分区、任务和标签交互，让您通过自然语言对话管理整个效率工作流。

Todoist MCP 服务搭建了 AI 助手与您的 Todoist 工作区之间的桥梁，让您通过对话界面无缝管理项目、分区、任务和标签。

目录

• 前提条件
• 用法
• MCP 工具
  • 项目
  • 分区
  • 任务
  • 标签
  • 评论
• 许可证

前提条件

使用此 MCP 服务前，您需要准备一个 Todoist API 令牌：

1. 前往 Todoist 开发者设置
2. 复制您的 API 令牌

用法

若要将此服务与 MCP 客户端配合使用，请添加以下配置：

{
  "mcpServers": {
    "todoist": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "TODOIST_API_TOKEN=<your_api_token_here>",
        "ghcr.io/koki-develop/todoist-mcp-server:latest"
      ]
    }
  }
}

将 <your_api_token_here> 替换为您实际的 Todoist API 令牌。

MCP 工具

此服务提供以下工具，供 AI 助手与您的 Todoist 数据交互：

• 项目
  • get_projects
  • get_project
  • create_project
  • update_project
  • delete_project
• 分区
  • get_sections
  • get_section
  • create_section
  • update_section
  • delete_section
• 任务
  • get_tasks
  • get_tasks_by_filter
  • get_task
  • create_task
  • update_task
  • delete_task
  • close_task
  • reopen_task
  • move_tasks_to_project
  • move_tasks_to_section
  • move_tasks_to_parent
• 标签
  • create_label
  • update_label
  • get_label
  • get_labels
  • delete_label
• 评论
  • create_task_comment
  • create_project_comment
  • update_comment
  • get_task_comments
  • get_project_comments
  • delete_comment

项目

get_projects

获取已通过身份验证的用户可访问的所有 Todoist 项目。返回全面的项目信息，包括个人项目和工作区项目，以及名称、颜色、收藏状态、视图样式和层级信息等元数据。

get_project

使用唯一标识符访问特定 Todoist 项目的详细信息。提供完整的项目元数据，包括配置、层级和组织详情。

create_project

创建一个可自定义设置的 Todoist 项目。

update_project

修改现有 Todoist 项目的属性。

delete_project

根据唯一标识符永久删除 Todoist 项目。此操作会删除该项目及其所有关联任务、分区和评论。此操作无法撤销。

分区

get_sections

获取 Todoist 项目中的所有分区。返回包含分区元数据的完整列表，例如名称、顺序、创建和更新时间戳以及状态信息。分区按其在项目中的显示顺序返回。

get_section

使用唯一标识符访问特定 Todoist 分区的详细信息。提供完整的分区元数据，包括名称、所属项目、顺序位置、时间戳和状态标记。

create_section

在 Todoist 项目中创建一个新分区，以便整理任务。分区有助于在项目中分类和归组相关任务。

update_section

修改现有 Todoist 分区的名称。目前只能更新分区名称。

delete_section

使用唯一标识符永久删除 Todoist 分区。此操作会移除该分区，并将其中的所有任务移至项目的主区域。此操作无法撤销。

任务

get_tasks

通过灵活的筛选选项获取 Todoist 任务。返回包含任务元数据的完整列表，包括内容、描述、所属项目、截止日期、优先级、标签、完成状态和层级信息。如果未指定筛选条件，则返回已通过身份验证的用户可访问的所有任务。

get_tasks_by_filter

使用高级筛选语法获取 Todoist 任务。支持使用 Todoist 的自然语言筛选语法进行强大的筛选查询，以便复杂地搜索任务。自动处理分页，以获取所有匹配的任务。

get_task

使用唯一标识符访问特定 Todoist 任务的详细信息。提供完整的任务元数据，包括内容、描述、所属项目和分区、截止日期信息、优先级、已分配的标签、完成状态、父子关系以及时间戳。

create_task

创建一个可全面配置的新 Todoist 任务。

update_task

修改现有 Todoist 任务的属性。

delete_task

使用唯一标识符永久删除 Todoist 任务。此操作会移除该任务及其所有相关评论和附件。如果任务包含子任务，这些子任务也会被删除。此操作无法撤销。

close_task

将 Todoist 任务标记为已完成。此操作会将任务移至已完成状态，同时保留所有任务数据和历史记录。如有需要，之后可以重新打开已完成的任务。

reopen_task

重新打开先前已完成的 Todoist 任务，使其恢复为活动状态。此操作会将任务还原至完成前的状态。

move_tasks_to_project

将多个任务移至 Todoist 中的其他项目。此工具可通过同时更改多个任务的所属项目，高效地批量整理任务。所有指定任务都将从当前位置移至目标项目。

move_tasks_to_section

将多个任务移至 Todoist 中的其他分区。此工具可通过一次更改多个任务所属的分区来批量整理任务。所有指定任务都将从当前位置移至目标分区。

move_tasks_to_parent

将多个任务设为 Todoist 中另一个任务的子任务。此工具可将多个任务设为指定父任务的子任务，从而建立任务层级。所有指定任务都将转换为目标父任务的子任务。

标签

create_label

创建一个可自定义属性的个人标签，包括名称、颜色、显示顺序和收藏状态。标签可用于跨项目分类和整理任务。

update_label

修改现有个人标签的属性。可更改标签名称、颜色、显示顺序和收藏状态。除标签 ID 外，所有参数均为可选，因此你可以只更新想要更改的属性。

get_label

根据唯一 ID 获取指定个人标签及其完整元数据，包括名称、颜色、顺序和收藏状态。返回所请求标签的详细信息，可用于任务整理和筛选。需要提供属于已认证用户的有效标签 ID。

get_labels

获取已认证用户可访问的所有个人标签及其完整元数据，包括名称、颜色、顺序和收藏状态。返回可用于任务整理和筛选的完整标签列表。此工具仅提供标签信息的只读访问，并会自动处理分页。

delete_label

根据唯一标识符永久删除个人标签。警告：此操作不可撤销，并会自动从所有关联任务中移除该标签。请谨慎操作，因为已删除的标签无法恢复。

评论

create_task_comment

向指定的 Todoist 任务添加评论。支持富文本内容和可选的文件附件。创建成功后，返回包含所有元数据的完整评论对象。

create_project_comment

向指定的 Todoist 项目添加评论。支持富文本内容和可选的文件附件。创建成功后，返回包含所有元数据的完整评论对象。

update_comment

更新 Todoist 中现有评论的内容。你可以借此修改任务或项目评论的文本内容。**评论的元数据（例如发布时间、作者和附件）会保留。**返回包含当前内容的更新后评论对象。

get_task_comments

获取与指定 Todoist 任务关联的所有评论。返回完整的评论列表及其元数据，包括内容、作者信息、时间戳、文件附件和回应。评论按时间顺序排列。会自动处理分页，以获取该任务的所有评论。

get_project_comments

获取与指定 Todoist 项目关联的所有评论。返回完整的项目级评论列表及其元数据，包括内容、作者信息、时间戳、文件附件和回应。评论按时间顺序排列。会自动处理分页，以获取该项目的所有评论。

delete_comment

根据唯一标识符永久删除评论。此操作会从关联的任务或项目中移除该评论。**此操作无法撤销，请谨慎操作。**返回删除成功的确认信息或失败通知。

许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

版权所有 (c) 2025 Koki Sato