🚀 Todoist MCP 服务器
Todoist MCP 服务器为 Todoist 提供了 Model Context Protocol (MCP) 支持，借助该服务器，Claude Desktop 及其他 MCP 兼容客户端能够实现高级任务与项目管理，极大提升管理效率。
🚀 快速开始
Todoist MCP 服务器可助力你通过 Claude Desktop 等 MCP 兼容客户端，对 Todoist 进行高级任务和项目管理。使用前，请确保满足以下需求：
- Node.js（推荐使用 v18 或更高版本）
- npm 或 yarn
- 一个 Todoist 账户
- 一个 Todoist API 令牌（参见 https://todoist.com/prefs/integrations）
✨ 主要特性
任务管理
- 可列出、创建、更新、完成、重新打开和删除任务。
项目管理
- 能列出、获取、创建、更新、存档、取消存档和删除项目。
部分管理
- 支持按项目列出、获取、创建、更新和删除部分（sections）。
标签管理
- 可列出、获取、创建、更新、删除和管理共享标签。
评论管理
- 能按任务或项目列出、获取、创建、更新和删除评论。
协作者管理
- 可列出项目的协作者。
📦 安装指南
用于 Claude Desktop（JSON）
若该项目作为 npm 包发布，可直接在你的 Claude Desktop 配置中使用：
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": [
"todoist-mcp"
],
"env": {
"TODOIST_API_TOKEN": "your_todoist_token"
}
}
}
}
- 请按上述方式设置
TODOIST_API_TOKEN。
手动安装
- 克隆仓库：
git clone https://github.com/yourusername/todoist-mcp.git
cd todoist-mcp
- 安装依赖项：
npm install
# 或
yarn install
- 构建项目：
npm run build
# 或
yarn build
- 将你的 Todoist API 令牌设置为环境变量（如上述 JSON 配置所示）。
- 运行构建好的服务器：
node dist/server.js
- 在你的配置文件中添加以下内容以使用本地构建：
{
"mcpServers": {
"todoist": {
"command": "node",
"args": [
"/path/to/todoist-mcp/dist/server.js"
],
"env": {
"TODOIST_API_TOKEN": "your_todoist_token"
}
}
}
}
💻 使用示例
基础用法
以下是一些使用该服务器的示例指令：
- 获取优先级最高的任务：
"Show me my top priority tasks."
- 创建和分类标签：
"Create labels for my tasks and classify them by project or urgency."
- 按部分整理任务：
"Move all tasks with the label 'urgent' to the 'Today' section."
- 项目管理：
"Create a new project called 'Personal Growth' and add a section 'Reading List'."
- 协作者概览：
"List all collaborators for the project 'Team Launch'."
- 评论管理：
"Add a comment to the task 'Prepare slides' with the content 'Remember to include Q2 results.'"
📄 许可证
该项目采用 MIT License。详细信息请参见 LICENSE。