JinDaGe - abhiz123_todoist-mcp-server MCP Details

article

README

🚀 Todoist MCP 服务器

Todoist MCP 服务器是一个集成了 Claude 与 Todoist 的 MCP（模型上下文协议）服务器实现。它允许用户通过日常用语来管理任务，让 Claude 能够使用自然语言与您的 Todoist 任务进行交互，极大地提升了任务管理的便捷性。

✨ 主要特性

自然语言任务管理：支持使用日常语言创建、更新、完成和删除任务，无需复杂的指令。
智能任务搜索：可通过部分名称匹配查找任务，快速定位所需任务。
灵活的过滤功能：能按截止日期、优先级和其他属性筛选任务，满足多样化的查询需求。
丰富的任务详情：支持描述、截止日期和优先级水平等详细信息的设置。
直观的错误处理：提供清晰的反馈，有效改善用户体验。

📦 安装指南

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

📚 详细文档

工具介绍

todoist_create_task

使用各种属性创建新任务：

必填项：内容（任务标题）
可选项：描述、截止日期、优先级水平（1 - 4）
示例：“创建任务‘团队会议’，附带说明‘每周同步’，设置为明天的任务”

todoist_get_tasks

检索并过滤任务：

按截止日期、优先级或项目筛选。
支持使用自然语言日期过滤。
结果限制可选。
示例：“显示此周的高优先级任务”

todoist_update_task

使用自然语言搜索更新现有任务：

通过部分名称匹配查找任务。
可更新任何任务属性（内容、描述、截止日期、优先级）。
示例：“将‘会议任务’设置为下周一截止”

todoist_complete_task

使用自然语言搜索标记任务完成：

使用名称查找并删除任务。
确认完成状态。
示例：“将‘文档任务’标记为已完成”

todoist_delete_task

使用自然语言搜索删除任务：

通过名称查找并删除任务。
显示确认消息。
示例：“删除‘代码审查任务’”

设置步骤

获取Todoist API令牌

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

与Claude Desktop一起使用

将以下内容添加到claude_desktop_config.json：

{
  "mcpServers": {
    "todoist": {
      "command": "npx",
      "args": ["-y", "@abhiz123/todoist-mcp-server"],
      "env": {
        "TODOIST_API_TOKEN": "此处输入您的API令牌"
      }
    }
  }
}

💻 使用示例

基础用法

# 创建任务
"创建任务‘团队会议’"
"添加任务‘审查PR’，设置为明天的任务"
"创建高优先级任务‘修复错误’，附带说明‘关键性能问题’"

# 获取任务
"显示所有我的任务"
"列出今天截止的任务"
"获取高优先级任务"
"显示此周的截止任务"

# 更新任务
"将文档任务设置为下周截止"
"更改错误修复任务的优先级为紧急"
"在团队会议任务中添加说明"

# 完成任务
"将PR审查任务标记为完成"
"完成文档任务"

# 删除任务
"删除代码审查任务"
"删除会议准备任务"

🔧 技术细节

从源码构建

# 克隆仓库
git clone https://github.com/abhiz123/todoist-mcp-server.git

# 进入目录
cd todoist-mcp-server

# 安装依赖项
npm install

# 构建项目
npm run build

🤝 贡献

欢迎贡献！随意提交 Pull Request。

📄 许可证

本项目在 MIT 许可证下发行——查看LICENSE文件获取详细信息。

❓ 问题与支持

如遇到任何问题或需要支持，请在GitHub 仓库提交问题。

abhiz123_todoist-mcp-server