关键词

TodoistAI集成任务管理项目协作LLM工具调用

项目简介

Todoist AI MCP服务器是一个基于Model Context Protocol (MCP) 构建的后端服务，旨在将强大的Todoist任务管理功能开放给大型语言模型（LLM）客户端。它提供了一系列标准化工具，允许LLM理解并执行用户的指令，例如创建任务、管理项目、查找待办事项、更新任务详情等，从而实现智能化的Todoist账户管理。

主要功能点

  • 任务管理：支持创建、更新、完成、查找和删除任务，包括设置优先级、截止日期、持续时间、标签以及负责人。
  • 项目与分区管理：允许创建、更新和查找项目及项目内的分区（Section），帮助组织任务。
  • 评论与协作：支持为任务和项目添加、更新和查找评论，并能查找项目协作者以便进行任务分配。
  • 批量操作：提供批量管理任务分配（分配、取消分配、重新分配）和批量完成任务的能力。
  • 概览与洞察：可生成账户或特定项目的Markdown格式概览，提供任务层级和进度信息。
  • 用户信息：获取用户的个人信息，包括时区、每日/每周目标等。

安装步骤

  1. 安装Node.js：请确保您的系统已安装Node.js（推荐LTS版本）。
  2. 安装Todoist AI库：在您的项目中，通过npm安装'@doist/todoist-ai'库。 
    npm install @doist/todoist-ai
  3. 配置API密钥：您需要一个Todoist API密钥。将其设置为环境变量'TODOIST_API_KEY'。例如，在您的'.env'文件中添加： 
    TODOIST_API_KEY=您的TodoistAPI密钥

服务器配置

MCP服务器需要MCP客户端进行连接。以下是为MCP客户端配置Todoist AI MCP服务器的JSON示例及参数说明。MCP客户端将使用这些信息来启动和连接到服务器。

{
  "mcpServers": {
    "todoist": {
      "name": "Todoist AI MCP 服务器",
      "command": "npx",
      "args": ["-y", "@doist/todoist-ai"],
      "environment": {
        "TODOIST_API_KEY": "你的Todoist API密钥"
      },
      "transport": "stdio",
      "url": "https://ai.todoist.net/mcp"
    }
  }
}
  • 'name': 服务器在客户端界面显示的名称（例如，"Todoist AI MCP 服务器"）。
  • 'command': 启动MCP服务器的可执行命令，这里推荐使用'npx'来直接运行Node.js包。
  • 'args': 传递给 'command' 的参数列表。例如，'["-y", "@doist/todoist-ai"]' 会执行已安装的 '@doist/todoist-ai' 包作为MCP服务器。
  • 'environment': 传递给服务器进程的环境变量。这里用于设置'TODOIST_API_KEY'，这是连接Todoist API所必需的。请务必替换为您的实际密钥。
  • 'transport': 服务器与客户端通信所使用的传输协议。'stdio'表示通过标准输入/输出进行通信。
  • 'url': 如果存在HTTP服务，这是一个可选的URL，MCP客户端也可以通过HTTP连接到预部署的服务（例如'https://ai.todoist.net/mcp'）。

基本使用方法

  1. 启动服务器：在终端中运行您的MCP客户端，并确保上述配置已加载。MCP客户端将根据配置自动启动并连接到Todoist AI MCP服务器。
  2. 通过LLM客户端交互：一旦连接成功，您可以通过LLM客户端（如Claude Desktop, Cursor等）与服务器进行交互。LLM将能够利用服务器提供的工具来执行Todoist操作，例如：
    • "创建一项任务，'购买食品杂货'，明天在我的'个人'项目中。"
    • "查找今天所有分配给John Doe的任务。"
    • "将任务'task-123'的优先级更新为P1，并将截止日期设置为下周五。"
    • "显示我'工作'项目的所有任务和分区的概览。"
  3. 开发集成：如果您是开发者，也可以直接在Node.js项目中导入并使用其提供的工具函数，或通过其SDK创建自定义的MCP客户端集成。

信息

分类

生产力应用

访问项目