Todoist MCP 服务器

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

<a href="https://glama.ai/mcp/servers/fhaif4fv1w"> <img width="380" height="200" src="https://glama.ai/mcp/servers/fhaif4fv1w/badge" alt="Todoist Server MCP server" /> </a>

功能

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

安装

通过 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（任务标题）
• 可选：description、due date、priority level (1-4)
• 示例："Create task 'Team Meeting' with description 'Weekly sync' due tomorrow" (创建任务“团队会议”，描述为“每周同步”，截止日期为明天)

todoist_get_tasks

检索和过滤任务：

• 按截止日期、优先级或项目过滤
• 自然语言日期过滤
• 可选的结果限制
• 示例："Show high priority tasks due this week" (显示本周的高优先级任务)

todoist_update_task

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

• 通过部分名称匹配查找任务
• 更新任何任务属性（content、description、due date、priority）
• 示例："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" (删除 PR 审查任务)

设置

获取 Todoist API Token

1. 登录到您的 Todoist 帐户
2. 导航到设置 → 集成
3. 在“开发者”下找到您的 API token

与 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" (添加任务“审查 PR”，截止日期为明天下午 2 点)
"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" (将 PR 审查任务标记为完成)
"Complete the documentation task" (完成文档任务)

删除任务

"Delete the PR review task" (删除 PR 审查任务)
"Remove meeting prep task" (删除会议准备任务)

开发

从源代码构建

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

# 导航到目录
cd todoist-mcp-server

# 安装依赖项
npm install

# 构建项目
npm run build

贡献

欢迎贡献！请随时提交 Pull Request。

许可证

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅 LICENSE 文件。

问题和支持

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