JinDaGe - todoist-mcp-server MCP Details

article

README

🚀 Todoist MCP 服务端

一个集成 Claude 的 Todoist MCP（模型上下文协议）服务器实现，支持自然语言任务管理。该服务器允许 Claude 使用日常语言与您的 Todoist 任务交互。

🚀 快速开始

Todoist MCP 服务端是一个集成了 Claude 的服务器实现，可让您使用自然语言进行任务管理，实现与 Todoist 任务的便捷交互。

✨ 主要特性

自然语言任务管理：使用日常语言创建、更新、完成和删除任务。
智能任务搜索：通过部分名称匹配查找任务。
灵活过滤：按截止日期、优先级和其他属性筛选任务。
详细的任务信息：支持描述、截止日期和优先级水平。
直观的错误处理：提供清晰的反馈以改善用户体验。

📦 安装指南

通过 Smithery 安装

要通过 Smithery 自动安装 Todoist MCP Server for Claude Desktop，可使用以下命令：

npx -y @smithery/cli install @abhiz123/todoist-mcp-server --client claude

手动安装

npm install -g @abhiz123/todoist-mcp-server

💻 使用示例

基础用法

创建任务

todoist_create_task --content "完成项目报告" --description "包含所有最新数据的详细报告"

获取任务

todoist_get_tasks --due_date "2023-10-31"

更新任务

todoist_update_task --task_id 123 --priority_level 2

完成任务

todoist_complete_task --task_id 456

删除任务

todoist_delete_task --task_id 789

高级用法

todoist_create_task

使用各种属性创建新任务，示例："Create task 'Team Meeting' with description 'Weekly sync' due tomorrow" 。该命令中，content（任务标题）为必填项，description、due_date、priority_level（1 - 4）为可选。

todoist_get_tasks

检索和筛选任务，可按截止日期、优先级或项目筛选，支持自然语言日期过滤，还可设置可选结果限制。示例："Show high priority tasks due this week" 。

todoist_update_task

使用自然语言搜索更新现有任务，通过部分名称匹配查找任务，并可更新任何任务属性（内容、描述、截止日期、优先级）。示例："Update meeting task to be due next Monday" 。

todoist_complete_task

使用自然语言搜索标记任务为完成，通过名称查找并删除任务，同时确认完成状态。示例："Mark the documentation task as complete" 。

todoist_delete_task

使用自然语言搜索删除任务，通过名称查找并删除任务，显示确认消息。示例："Delete the PR review task" 。

📚 详细文档

设置

获取 Todoist API Token

登录您的 Todoist 账户。
导航到设置 → 集成。
在“开发者”下找到您的 API 令牌。

与 Claude Desktop 使用

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_KEY": "your_api_key_here"
      }
    }
  }
}

开发信息

要贡献到项目或进行开发，请参考 GitHub 仓库。

贡献指南

欢迎贡献！请提交拉取请求或报告问题到 GitHub。

📄 许可证

项目遵循 MIT License。

问题支持

如遇问题，请访问 GitHub Issues 或联系维护人员。

todoist-mcp-server