Todoist

🚀 Todoist MCP 服务器

Todoist MCP 服务器是一个与 Todoist 整合的 Model Context Protocol (MCP) 服务器实现，它能让 Claude 和其他 AI 助手通过自然语言进行任务管理，为任务管理带来了极大的便利。

🚀 快速开始

你需要一个 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"
            }
        }
    }
}

✨ 主要特性

• 完整的 Todoist API 集成：支持 Todoist REST API v2 和通过自然语言的 Todoist 同步 API。
• 批量处理：客户端可以一次请求处理多个任务。
• 按名称搜索：AI 可以通过名称搜索任务、项目和标签，而无需 ID。
• 任务管理：创建、更新、关闭、重新打开、移动和删除任务，使用自然语言即可。
• 项目管理：创建和管理项目和部分。
• 评论功能：添加和管理任务和项目上的评论。
• 标签管理：创建和管理个人和共享标签。
• 提示支持：你可以轻松地为客户端提供项目信息。

📦 安装指南

# 安装项目
npm install

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

💻 使用示例

基础用法

# 安装项目
npm install

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

📚 详细文档

可用工具

任务管理

• get_tasks_list：获取任务列表，可选按项目、部分、标签等过滤。
• create_tasks：创建新任务，带有各种属性。
• get_tasks：通过 ID 或名称获取特定任务。
• update_tasks：更新现有任务。
• close_tasks：关闭任务。
• reopen_tasks：重新打开任务。
• move_task：移动任务。

项目管理

• create_project：创建新项目。
• get_projects：获取所有项目。
• get_project：通过 ID 获取特定项目。
• update_project：更新现有项目。
• delete_project：删除项目。

标签管理

• create_label：创建新标签。
• get_labels：获取所有标签。
• get_label：通过 ID 获取特定标签。
• update_label：更新现有标签。
• delete_label：删除标签。

📄 许可证

此项目使用 MIT 许可证，详细信息请查看 LICENSE 文件。

问题与支持

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