关键词

任务管理Todoist效率个人助理Claude集成

项目简介

MCP Todoist Server 是一个基于 Model Context Protocol (MCP) 构建的服务器，它充当 Claude 等 LLM 应用与 Todoist 任务管理服务之间的桥梁。通过此服务器，您可以让 Claude 理解和操作您的 Todoist 任务、项目和标签，从而实现更智能的任务管理和工作流程自动化。

主要功能点

  • 任务管理: 创建、更新、完成和删除 Todoist 中的任务。
  • 项目管理: 组织和管理 Todoist 项目，包括创建、更新和删除项目。
  • 标签管理: 管理 Todoist 标签，方便对任务进行分类和过滤。
  • 任务搜索与过滤: 根据各种条件（如项目、标签、截止日期、优先级等）搜索和过滤任务。
  • 与 Claude Desktop 无缝集成: 专为与 Claude Desktop 配合使用而设计，提供便捷的配置和使用体验。

安装步骤

  1. 安装 Astral UV: 确保您的系统已安装 Astral UV，这是一个用于 Python 包管理的工具。
  2. 安装 MCP Todoist Server: 使用 UVX 命令安装 MCP Todoist Server。 
    uvx mcp-todoist
  3. 配置 Todoist API Token:
    • 访问 Todoist 集成设置 获取您的 Todoist API Token。
    • 将 API Token 设置为环境变量 'TODOIST_API_TOKEN'。您可以将以下行添加到您的 '.env' 文件或系统环境变量中： 
      TODOIST_API_TOKEN=your_api_token_here

服务器配置

为了让 Claude Desktop 能够连接到 MCP Todoist Server，您需要配置 Claude Desktop 的配置文件。打开 Claude Desktop 配置文件（通常位于 '~/.config/claude/claude_desktop_config.json' 或等效路径），并添加或修改 'mcpServers' 部分，如下所示：

{
  "mcpServers": {
    "mcp-todoist": {
      "command": "uvx",
      "args": ["mcp-todoist"]
    }
  }
}

配置参数说明:

  • '"mcp-todoist"': 服务器名称，在 Claude Desktop 中用于标识此 MCP 服务器。
  • '"command": "uvx"': 启动 MCP Todoist Server 的命令，这里使用 'uvx' 命令来运行已安装的 'mcp-todoist' 包。
  • '"args": ["mcp-todoist"]': 传递给 'uvx' 命令的参数，指定要运行的包名称为 'mcp-todoist'。

基本使用方法

完成安装和配置后，您就可以在 Claude 中使用自然语言指令来操作您的 Todoist 账户了。以下是一些使用示例：

  • 查看今日任务: "Show me my tasks due today"
  • 创建新任务: "Create a new task to buy groceries tomorrow"
  • 标记任务完成: "Mark my 'send email' task as complete"
  • 创建新项目: "Create a new project called 'Home Renovation'"
  • 查看项目任务: "Show me all tasks in my Work project"

您可以参考仓库 README 中 “Available Tools” 章节了解所有可用的工具名称和功能，以便更有效地与 Claude 互动，管理您的 Todoist 任务。

例如，要列出所有标签，您可以使用 'list-labels' 工具；要创建一个名为 "urgent" 的标签，可以使用 'create-label' 工具，并提供标签名称 "urgent" 作为参数。Claude 会根据您的指令和可用的工具，自动调用 MCP Todoist Server 来执行相应的操作。

信息

分类

生产力应用

访问项目