JinDaGe - todoist MCP Details

article

README

🚀 Todoist MCP 服务器

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

🚀 快速开始

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

获取 Todoist API 令牌

登录到你的 Todoist 账户。
进入设置 → 集成。
在“开发者”部分找到你的 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 仓库中提交问题。

todoist