Todoist MCP 服务器

一个实现了模型上下文协议（MCP）的服务器，它将Claude及其他AI助手与Todoist集成起来，使通过自然语言进行任务管理成为可能。

功能

• 完整的 Todoist API 集成：访问完整的 Todoist REST API v2，并通过自然语言支持 Todoist Sync API
• 批量处理：客户端可以在单个请求中处理多个任务
• 按名称搜索：AI 可以根据名称而不是 ID 来搜索任务、项目和标签
• 任务：使用对话语言创建、更新、关闭、重新打开、移动和删除任务
• 项目：创建和管理项目及部分
• 评论：在任务和项目上添加和管理评论
• 标签：创建和个人共享标签
• 提示支持：您可以轻松地向客户端提供关于您的项目的相关信息

配置

要使用此 MCP 服务器，您需要一个 Todoist API 令牌。

获取 Todoist API 令牌

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

与 Claude 桌面版配合使用

将以下内容添加到您的 claude_desktop_config.json 文件中：

{
    "mcpServers": {
        "todoist": {
            "command": "npx",
            "args": ["-y", "todoist-mcp"],
            "env": {
                "API_KEY": "your_todoist_api_token_here"
            }
        }
    }
}

可用工具

任务

• get_tasks_list: 获取任务列表，可选通过项目、部分、标签等过滤
• create_tasks: 创建具有各种属性的新任务
• get_tasks: 按 ID 或名称获取特定任务
• update_tasks: 更新现有任务
• close_tasks: 标记任务为完成
• reopen_tasks: 重新打开已完成的任务
• delete_tasks: 删除任务
• move_tasks: 将任务移动到不同的项目或部分

项目

• get_projects_list: 获取所有项目
• create_projects: 创建新项目
• get_projects: 按 ID 或名称获取特定项目
• update_projects: 更新现有项目
• delete_projects: 删除项目
• get_collaborators: 获取项目的全部协作者
• move_projects: 将项目移动到不同的位置或子项目

部分

• get_sections_list: 获取所有部分或按项目过滤
• create_sections: 创建新部分
• get_sections: 按 ID 或名称获取特定部分
• update_sections: 更新部分
• delete_sections: 删除部分

评论

• get_comments_list: 获取项目或任务的评论
• create_comments: 创建新评论
• get_comments: 按 ID 获取特定评论
• update_comments: 更新评论
• delete_comments: 删除评论

标签

• get_labels_list: 获取所有个人标签
• create_labels: 创建新的个人标签
• get_labels: 通过ID或名称获取个人标签
• update_labels: 更新个人标签
• delete_labels: 删除个人标签
• get_shared_labels: 获取所有共享标签
• rename_shared_labels: 重命名共享标签
• remove_shared_labels: 移除共享标签

工具

• utils_get_colors: 获取可用于项目、标签和过滤器的颜色

提示

• projects_list: 以 markdown 格式获取带有其部分和参数的项目列表

使用示例

可以向您的AI助手（如Claude）提问如下：

"What tasks do I have due today?"
"Create a task to review the quarterly report by next Friday"
"Make a new project called 'Home Renovation'"
"Add a comment to my meeting prep task"
"Show me all my high priority tasks"
"Create a label for 'Urgent' tasks with a red color"
"What projects do I have in my Todoist?"
"Mark my dentist appointment task as complete"

开发

# Install dependencies
npm install

# Build the project and run inspector
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

许可证

本项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。

问题和支持

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