Todoist MCP 服务器

一个集成了Claude和其他AI助手的模型上下文协议（MCP）服务器实现，能够通过自然语言管理Todoist任务。

功能

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

配置

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

获取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）提问，例如：

“我今天有哪些任务要完成？”
“创建一个任务，要求在下周五之前审查季度报告”
“创建一个名为‘家庭装修’的新项目”
“在我的会议准备任务中添加评论”
“显示我所有高优先级的任务”
“创建一个标签，用于标记‘紧急’任务，颜色为红色”
“我的Todoist中有哪些项目？”
“将我的牙医预约任务标记为完成”

开发

# 安装依赖
npm install

# 构建项目并运行检查器
npm run build && npx @modelcontextprotocol/inspector -e API_KEY=YOUR_API_KEY_HERE node dist/index.js

许可证

本项目遵循MIT许可证 - 详情请参阅LICENSE文件。

问题和支持

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