Todoist MCP Server

Todoist MCP 服务

一个 MCP（Model Context Protocol）服务实现，可将 Claude 与 Todoist 集成，实现自然语言任务管理。此服务可让 Claude 使用日常语言与您的 Todoist 任务交互。

功能

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

安装

通过 Smithery 安装

要通过 Smithery 为 Claude Desktop 自动安装 Todoist MCP 服务：

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

手动安装

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

工具

todoist_create_task

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

• 必填：content（任务标题）
• 可选：描述、截止日期、优先级（1-4）
• 示例：“创建任务 ‘Team Meeting’，描述为 ‘Weekly sync’，截止日期为明天”

todoist_get_tasks

检索和筛选任务：

• 按截止日期、优先级或项目筛选
• 自然语言日期筛选
• 可选结果数量上限
• 示例：“显示本周到期的高优先级任务”

todoist_update_task

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

• 通过部分名称匹配查找任务
• 更新任意任务属性（content、描述、截止日期、优先级）
• 示例：“将会议任务的截止日期改为下周一”

todoist_complete_task

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

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

todoist_delete_task

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

• 按名称查找并删除任务
• 提供确认消息
• 示例：“删除 PR 审查任务”

设置

获取 Todoist API 令牌

1. 登录 Todoist 账户
2. 前往 Settings → Integrations
3. 在 “Developer” 下找到 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"
      }
    }
  }
}

使用示例

创建任务

"Create task 'Team Meeting'"
"Add task 'Review PR' due tomorrow at 2pm"
"Create high priority task 'Fix bug' with description 'Critical performance issue'"

获取任务

"Show all my tasks"
"List tasks due today"
"Get high priority tasks"
"Show tasks due this week"

更新任务

"Update documentation task to be due next week"
"Change priority of bug fix task to urgent"
"Add description to team meeting task"

完成任务

"Mark the PR review task as complete"
"Complete the documentation task"

删除任务

"Delete the PR review task"
"Remove meeting prep task"

开发

从源代码构建

# Clone the repository
git clone https://github.com/abhiz123/todoist-mcp-server.git

# Navigate to directory
cd todoist-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

贡献

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

许可证

本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。

问题与支持

如果您遇到问题或需要支持，请在 GitHub 仓库中提交 issue。