使用说明
todoist mcp
A. 模型上下文协议（MCP） 将Claude连接到Todoist的服务器。直接从Claude管理任务、项目、部分、标签和注释，无需复制粘贴。
工具
任务
| 工具 | 说明 |
|---|---|
get_tasks |
列出活动任务，按项目、部分、父项、标签或ID进行筛选 |
get_tasks_by_filter |
使用Todoist筛选器语法查询任务(today, p1 & #Work, overdue等等） |
create_task |
创建具有全面现场支持的任务 |
quick_add_task |
使用自然语言创建任务(Buy milk tomorrow p2 @shopping #Groceries) |
update_task |
更新任务，包括将其移动到其他项目/部分/父级 |
close_task |
标记任务已完成 |
项目
| 工具 | 说明 |
|---|---|
get_projects |
列出所有项目 |
章节
| 工具 | 说明 |
|---|---|
get_sections |
列出部分，可选择按项目筛选 |
get_section |
按ID获取单个部分 |
create_section |
在项目中创建一个部分 |
update_section |
重命名分区 |
delete_section |
删除一个部分及其内的所有任务 |
标签
| 工具 | 说明 |
|---|---|
get_labels |
列出所有个人标签 |
create_label |
创建新标签 |
update_label |
重命名或重新着色标签 |
delete_label |
删除标签 |
评论
| 工具 | 说明 |
|---|---|
get_comments |
列出对任务或项目的评论 |
add_comment |
向任务或项目添加注释 |
update_comment |
编辑评论 |
delete_comment |
删除评论 |
设置
1.获取Todoist API代币
转到Todoist→ 设置→ 集成→ 开发者→ 复制您的API令牌。
2.配置克劳德桌面
将以下内容添加到您的 claude_desktop_config.json:
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
窗户： %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"todoist": {
"command": "npx",
"args": ["-y", "github:carentsen/todoist-mcp"],
"env": {
"TODOIST_API_TOKEN": "your_token_here"
}
}
}
}
保存后重新启动Claude Desktop。
许可证级别
某些功能需要Todoist Pro或商务计划。服务器在启动时自动检测您的计划。你可以用以下命令覆盖它 TODOIST_LICENSE 环境变量：
"env": {
"TODOIST_API_TOKEN": "your_token_here",
"TODOIST_LICENSE": "pro"
}
| 价值 | 功能已解锁 |
|---|---|
free |
所有基本任务、项目、部分、标签和评论工具 |
pro |
+ deadline_date, duration, reminder |
business |
+ assignee_id |
发展
npm install
npm run build # compile TypeScript → dist/
npm run dev # watch mode
复制 .env.example 到 .env 并设置您的 TODOIST_API_TOKEN 用于本地测试。
许可证
麻省理工学院
