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 用于本地测试。
许可证
麻省理工学院