项目说明

<h1>Todoist MCP 服务器</h1>
<p>一个与 Todoist 整合的 Model Context Protocol (MCP) 服务器实现，使 Claude 和其他 AI 助手能够通过自然语言进行任务管理。</p>
<div>
    
    
    <a href="https://www.npmjs.com/package/todoist-mcp" target="_blank">
        
    </a>
</div>

功能特点

• 完整的 Todoist API 集成：支持 Todoist REST API v2 和通过自然语言的 Todoist 同步 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：重新打开任务
• move_task：移动任务

项目管理

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

标签管理

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

使用示例

# 安装项目
npm install

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

许可证

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

问题与支持

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