todoist-mcp

<div align="center"> <img src="https://static-00.iconduck.com/assets.00/todoist-icon-512x512-v3a6dxo9.png" width="120"/> <h1>Todoist MCP 服务器</h1> <p>一个模型上下文协议 (MCP) 服务器实现，将 Claude 和其他 AI 助手与 Todoist 集成，从而实现自然语言任务管理。</p> <div> <img src="https://img.shields.io/badge/claude-mcp-blue" alt="MCP Server"> <img src="https://img.shields.io/badge/todoist-mcp-orange" alt="Todoist Integration"> <a href="https://www.npmjs.com/package/todoist-mcp" target="_blank"> <img src="https://img.shields.io/npm/v/todoist-mcp.svg" alt="npm version"> </a> </div> </div>

功能

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

配置

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

获取 Todoist API 令牌

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

与 Claude Desktop 一起使用

添加到您的 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 存储库上提交问题。

<a href="https://glama.ai/mcp/servers/@stanislavlysenko0912/todoist-mcp-server"> <img width="380" height="200" src="https://glama.ai/mcp/servers/@stanislavlysenko0912/todoist-mcp-server/badge" /> </a>