Todoist MCP Server

这是一个将Claude与Todoist集成的MCP（模型上下文协议）服务器实现，支持使用自然语言进行任务管理。此服务器允许Claude通过日常语言与你的Todoist任务进行交互。

<a href="https://glama.ai/mcp/servers/fhaif4fv1w"> <img width="380" height="200" src="https://gips3.baidu.com/it/u=3842561959,2509160587&fm=3081&app=3081&f=PNG?w=760&h=400" alt="Todoist Server MCP 服务器" /> </a>

功能

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

安装

通过 Smithery 安装

要通过 Smithery 自动安装 Todoist MCP Server：

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

手动安装

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

工具

todoist_create_task

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

• 必需：内容（任务标题）
• 可选：描述、截止日期、优先级级别（1-4）
• 示例："创建任务 '团队会议'，描述 '每周同步'，截止日期为明天"

todoist_get_tasks

检索并筛选任务：

• 按截止日期、优先级或项目筛选
• 使用自然语言日期筛选
• 可选结果限制
• 示例："显示本周内到期的高优先级任务"

todoist_update_task

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

• 通过部分名称匹配找到任务
• 更新任何任务属性（内容、描述、截止日期、优先级）
• 示例："将会议任务的截止日期更新为下周一"

todoist_complete_task

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

• 通过部分名称匹配找到任务
• 确认完成状态
• 示例："将文档任务标记为已完成"

todoist_delete_task

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

• 通过名称找到并删除任务
• 确认消息
• 示例："删除 PR 审查任务"

设置

获取 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": "your_api_token_here"
      }
    }
  }
}

示例用法

创建任务

"创建任务 '团队会议'"
"添加任务 '审查 PR'，截止日期为明天下午2点"
"创建高优先级任务 '修复 Bug'，描述 '关键性能问题'"

获取任务

"显示我的所有任务"
"列出今天到期的任务"
"获取高优先级任务"
"显示本周到期的任务"

更新任务

"将文档任务的截止日期更新为下周"
"将 Bug 修复任务的优先级更改为紧急"
"给团队会议任务添加描述"

完成任务

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

删除任务

"删除 PR 审查任务"
"移除会议准备任务"

开发

从源代码构建

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

# 进入目录
cd todoist-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

贡献

欢迎贡献！请随意提交拉取请求。

许可证

本项目采用 MIT 许可证 - 详情见 LICENSE 文件。

问题和支持

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