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令牌

1. 登录到您的Todoist账户
2. 转到设置 → 集成
3. 在“开发者”部分找到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仓库提交问题。