AI导哈

Todoist任务管理服务器

通过REST API连接Todoist与Claude的任务管理服务器，支持任务、项目、标签和评论的全面管理。

  • by shawkatdidar
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 shawkatdidar/todoist_claude_mcp_server_v1.0

使用说明

Todoist MCP 服务器

MCP服务器通过REST API连接Todoist与Claude。您可直接在Claude中管理您的Todoist任务、项目、板块、标签和评论。

特点/功能

  • 任务管理创建、更新、完成和删除任务
  • 项目管理查看你所有的Todoist项目
  • 部门管理获取项目内的部分/章节
  • 标签管理查看并使用标签来组织任务
  • 评论阅读任务和项目的评论
  • 高级过滤按项目或标签筛选任务
  • 优先支持设置任务优先级，从1（正常）到4（紧急）
  • 截止日期设置并更新任务截止日期

安装

史密斯里路（推荐）

npx @smithery/cli install todoist-mcp-server

在安装过程中，系统会提示您输入您的Todoist API令牌。

如何获取您的Todoist API令牌：

  1. 首选 Todoist 设置 → 集成
  2. 向下滚动到“开发者”部分
  3. 复制您的API令牌
  4. 在安装过程中，当Smithery提示时，请粘贴它

手动安装

  1. 克隆此存储库：
git clone https://github.com/shawkatdidar/todoist_claude_mcp_server_v1.0.git
cd todoist_claude_mcp_server_v1.0
  1. 安装依赖项：
pip install -r requirements.txt

  1. 从以下位置获取您的Todoist API令牌： Todoist 设置 > 集成 > 开发者

  2. 设置你的环境变量：

export TODOIST_API_TOKEN=your_token_here

配置

对于Claude Desktop

将此添加到您的Claude桌面配置文件中：

macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "todoist": {
      "command": "python",
      "args": ["/path/to/todoist_claude_mcp_server_v1.0/server.py"],
      "env": {
        "TODOIST_API_TOKEN": "your_token_here"
      }
    }
  }
}

对于Smithery（Claude.ai）

使用 Smithery 安装时，设置过程中会提示您输入 TODOIST_API_TOKEN。Smithery 将安全地存储您的令牌，并自动将其提供给 MCP 服务器。

注每位用户都需要自己的Todoist API令牌。该令牌是个人专用的，不应与他人共享。

可用工具

工具 描述
------ -------------
获取所有任务，可选择按项目或标签进行过滤 get_projects
从Todoist获取所有项目 get_sections
获取所有部分，可选择按项目过滤 get_labels
从Todoist获取所有标签 get_comments
获取特定任务或项目的评论 create_task
创建一个新任务，可选择项目、部分、截止日期、优先级和标签 update_task
更新现有任务 complete_task
将任务标记为已完成 delete_task

| 删除任务 |

使用示例

  • 安装后，您可以向Claude提问：
  • “我今天的任务是什么？”
  • “创建一个优先级为3的购买杂货任务”
  • “显示我所有的项目”
  • “完成任务 [任务ID]”

“将任务[task_id]的截止日期更新为2025年12月31日”

  • 要求
  • Python 3.10+
  • httpx 版本 >= 0.27.0
  • python-dotenv >= 1.0.0
  • mcp >= 0.1.0（可翻译为：mcp 版本大于等于 0.1.0）

坚韧性（或持久性）版本 >= 8.2.0

许可证

麻省理工学院（MIT）

作者

相关 MCP