Todoist MCP Server

这是一个模型上下文协议（MCP）服务器，它连接了Todoist API与AI助手如Claude。该服务器使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

将多个任务移动成为另一个任务的子任务。此工具通过将多个任务变为指定父任务的子任务来创建任务层次结构。所有指定的任务都将转换为目标父任务的子任务。

标签

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