关键词

Todoist任务管理LLM工具效率提升自然语言交互

项目简介

Todoist MCP Server Extended 是一个基于 Model Context Protocol (MCP) 构建的服务器，旨在弥合自然语言模型（如 Claude）与 Todoist 任务管理应用之间的鸿沟。通过此服务器，LLM 可以调用预定义的工具，以自然语言指令创建、更新、查询和完成 Todoist 中的任务、项目、标签和分区，从而实现更智能、更高效的任务管理流程。

主要功能点

  • 任务管理: 使用自然语言创建、更新、完成和删除 Todoist 任务。
  • 标签管理: 创建、更新和管理个人标签和任务标签。
  • 项目管理: 创建和管理 Todoist 项目。
  • 分区组织: 在项目中创建和管理分区。
  • 智能搜索: 使用部分名称匹配查找任务和标签。
  • 灵活过滤: 按项目、分区、截止日期、优先级和标签过滤任务。
  • 丰富的任务详情: 支持任务描述、截止日期、优先级和项目/分区分配。
  • 批量操作: 工具内置批量操作支持和自定义参数，以提高 LLM 工作流程的效率。

安装步骤

您可以通过 Smithery 或 npm 安装 Todoist MCP Server Extended。

通过 Smithery 安装 (推荐 Claude Desktop 用户):

  1. 确保您已安装 Smithery CLI。
  2. 打开命令行终端（cmd 或 PowerShell）。
  3. 运行以下命令，为 Claude Desktop 安装服务器： 
    npx -y @smithery/cli install @Chrusic/todoist-mcp-server-extended --client claude
    如果您使用其他 MCP 客户端（如 cline 或 windsurf），请将 '--client claude' 替换为 '--client cline' 或 '--client windsurf'。

通过 npm 安装:

  1. 确保您已安装 Node.js 和 npm。
  2. 打开命令行终端（cmd 或 PowerShell）。
  3. 运行以下命令全局安装服务器： 
    npm install -g @chrusic/todoist-mcp-server-extended

服务器配置

要将 Todoist MCP Server Extended 与 MCP 客户端（例如 Claude Desktop）一起使用，您需要配置客户端以连接到此服务器。您需要提供服务器的启动命令和 Todoist API 令牌。

以下是在 'claude_desktop_config.json' 文件中配置服务器的 JSON 代码片段。请将以下代码添加到 '"mcpServers":{ }:' 部分中，并替换 '"PASTE-YOUR-API-TOKEN-HERE"' 为您的实际 Todoist API 令牌。

"todoist": {
  "command": "npx",
  "args": ["-y", "@chrusic/todoist-mcp-server-extended"],
  "env": {
      "TODOIST_API_TOKEN": "PASTE-YOUR-API-TOKEN-HERE"
  }
}

获取 Todoist API 令牌:

  1. 登录到您的 Todoist 账户。
  2. 导航到 '设置 → 集成'。
  3. 在 '开发者' 下找到您的 API 令牌。
  4. 点击 '复制 API 令牌'。

基本使用方法

配置完成后，您的 MCP 客户端将会在启动时自动启动 Todoist MCP Server Extended。您可以使用自然语言指令指示 LLM 使用 'todoist_' 开头的工具与 Todoist 进行交互。

例如，您可以向 Claude 提出以下指令：

  • "使用工具 'todoist_get_tasks'，列出我今天的所有任务。"
  • "在 '工作' 项目的 '待办' 分区中创建一个名为 '审查 PR' 的任务。"
  • "为任务 '审查 PR' 添加标签 '重要'。"
  • "显示 '工作' 项目中所有带有 '重要' 标签的任务。"
  • "将任务 '文档' 移动到 '进行中' 分区。"
  • "将文档任务标记为已完成。"

请注意，为了让 LLM 准确调用工具，您可能需要使用较为明确的指令。

信息

分类

生产力应用

访问项目