使用说明
Todoist MCP服务器
Todoist API v1.的模型上下文协议（MCP）服务器。提供44个带有只读/写注释的工具，以便Claude Desktop正确分组。
在Claude Desktop中安装（推荐）
下载或构建 todoist-mcp-server.mcpb，然后双击它（或将其拖动到Claude Desktop中→ 设置→ 扩展）。Claude Desktop将提示您 Todoist API代币 在安装过程中。
从以下位置获取您的API令牌：https://app.todoist.com/app/settings/integrations/developer
从源代码构建.mcpb
需要 just (brew install just):
just bundle
这将安装deps、编译、暂存一个干净的依赖树并打包 todoist-mcp-server.mcpb 在repo根目录下。其他食谱： just build, just run, just clean.快跑 just 没有参数来列出它们。
手动配置（备选）
如果你宁愿直接连接服务器而不打包：
just build
创建一个 .env 文件：
TODOIST_API_TOKEN=your_todoist_api_token_here
添加 ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"todoist": {
"command": "node",
"args": ["/path/to/todoist-mcp-server/dist/index.js"],
"env": {
"TODOIST_API_TOKEN": "your_token_here"
}
}
}
}
工具（共44个）
只读（22）
| 工具 | 说明 |
|---|---|
find-tasks-by-date |
按截止日期范围查找任务 |
fetch |
直接获取任何Todoist API URL |
fetch-object |
按类型和ID获取特定对象 |
find-activity |
最近的活动（已完成的任务） |
find-comments |
对任务或项目的评论 |
find-completed-tasks |
带日期过滤的已完成任务 |
find-filters |
用户定义的过滤器（指导——通过应用程序管理） |
find-labels |
个人标签 |
find-project-collaborators |
项目合作者 |
find-projects |
所有项目 |
find-reminders |
所有提醒 |
find-sections |
章节（可选按项目） |
find-tasks |
具有过滤功能的活动任务 |
get-overview |
带有任务计数的工作区概述 |
get-productivity-stats |
因果、条纹、每日/每周趋势 |
get-project-activity-stats |
项目已完成的任务 |
get-project-health |
项目健康分析 |
get-workspace-insights |
跨工作区分析 |
list-workspaces |
用户帐户和工作区信息 |
search |
按内容、描述或标签搜索任务 |
user-info |
经过身份验证的用户详细信息 |
view-attachment |
查看评论附件 |
analyze-project-health |
深入项目健康分析并提出建议 |
写作（19）
| 工具 | 说明 |
|---|---|
add-comments |
向任务/项目添加注释 |
add-filters |
创建过滤器（指导——通过应用程序管理） |
add-labels |
创建个人标签 |
add-projects |
创建项目 |
add-reminders |
添加任务提醒（需要专业版） |
add-sections |
创建项目部分 |
add-tasks |
创建包含子任务、标签、优先级和截止日期的任务 |
complete-tasks |
标记任务已完成 |
manage-assignments |
在共享项目中分配/取消分配任务 |
project-management |
批量项目更新/删除 |
project-move |
按顺序重新定位项目 |
reorder-objects |
重新排序任务、项目或部分 |
reschedule-tasks |
批量重新安排任务到期日期 |
uncomplete-tasks |
重新打开已完成的任务 |
update-comments |
更新评论内容 |
update-filters |
更新过滤器（指导——通过应用程序管理） |
update-projects |
更新项目属性 |
update-reminders |
更新提醒设置 |
update-sections |
更新节名称 |
update-tasks |
更新任务（包括在部门/项目之间移动） |
破坏性（1）
| 工具 | 说明 |
|---|---|
delete-object |
删除任何对象（任务、项目、部分、注释、标签） |
API覆盖范围
使用 Todoist API v1 (https://api.todoist.com/api/v1/).自动处理分页响应。
| 资源 | 读取 | 创建 | 更新 | 删除 | 移动 |
|---|---|---|---|---|---|
| 任务 | 是 | 是 | 有 | 有 | 是 |
| 项目 | 是 | 是 | 对 | 是 | 有 |
| 章节 | 是 | 是 | 有 | 有 | 是 |
| 评论 | 是 | 是 | 有 | 有 | - |
| 标签 | 是 | 是 | 有 | 有 | - |
| 提醒 | 是 | 是 | 有 | -- | -- |
| 已完成的任务 | 是 | -- | -- | -- | -- |
| 生产率统计 | 是 | -- | -- | -- | -- |
| 用户信息 | 是 | -- | -- | --- | -- |
| 合作者 | 是 | -- | -- | -- | -- |
备注
- 过滤器：Todoist API v1不公开筛选器CRUD。这
add-filters/update-filters工具返回使用Todoist应用程序的指南。使用find-tasks具有类似过滤器行为的参数。 - 提醒事项：需要Todoist Pro计划。这些工具工作正常，但会在免费帐户上返回HTTP 403。
- 工具注释：所有工具包括
readOnlyHint/destructiveHint因此，Claude Desktop将它们分为只读、写入和破坏性类别。
