使用说明
Todoist MCP服务器
Todoist的模型上下文协议（MCP）服务器，通过Claude Desktop和其他兼容MCP的客户端实现高级任务和项目管理。
需求
- Node.js（建议使用v18或更高版本）
- npm或纱线
- Todoist帐户
- Todoist API令牌（请参阅https://todoist.com/prefs/integrations)
特性
- 列出、创建、更新、完成、重新打开和删除任务
- 列出、创建、更新、存档、取消存档和删除项目
- 列出、创建、更新和删除部分
- 列出、创建、更新和删除标签
- 列出、创建、更新和删除评论
- 管理共享标签
- 获取项目合作者
所有功能
- 任务：列表、获取、创建、更新、完成、重新打开、删除
- 项目：列表、获取、创建、更新、存档、取消存档、删除
- 章节：列表（按项目）、获取、创建、更新、删除
- 标签：列出、获取、创建、更新、删除、管理共享标签
- 评论：列表（按任务/项目）、获取、创建、更新、删除
- 合作者：列出项目合作者
安装
适用于Claude Desktop（JSON）
如果发布为npm包，您可以在Claude Desktop配置中直接将其与npx一起使用：
{
"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 # or yarn install - 构建项目：
npm run build # or yarn build - 将Todoist API令牌设置为环境变量（请参见上文）。
- 运行内置服务器：
node dist/server.js - 通过将以下内容添加到配置文件中，配置Claude Desktop以使用您的本地版本：
{ "mcpServers": { "todoist": { "command": "node", "args": [ "/path/to/todoist-mcp/dist/server.js" ], "env": { "TODOIST_API_TOKEN": "your_todoist_token" } } } }
使用示例
- 获取首要任务：
“显示我的首要任务。”
- 创建和分类标签：
“为我的任务创建标签，并按项目或紧急程度对其进行分类。”
- 按部门组织任务：
“将所有带有“紧急”标签的任务移至“今天”部分。”
- 项目管理：
“创建一个名为“个人成长”的新项目，并添加一个“阅读列表”部分。”
- 协作者概述：
“列出“团队启动”项目的所有合作者。”
- 评论管理：
在“准备幻灯片”任务中添加注释，内容为“记住要包括第二季度的结果”
许可证
该项目根据MIT许可证获得许可。看 许可证 了解详情。
