Todoist MCP 服务器
MCP服务器通过REST API连接Todoist与Claude。您可直接在Claude中管理您的Todoist任务、项目、板块、标签和评论。
特点/功能
- 任务管理创建、更新、完成和删除任务
- 项目管理查看你所有的Todoist项目
- 部门管理获取项目内的部分/章节
- 标签管理查看并使用标签来组织任务
- 评论阅读任务和项目的评论
- 高级过滤按项目或标签筛选任务
- 优先支持设置任务优先级，从1（正常）到4（紧急）
- 截止日期设置并更新任务截止日期
安装
史密斯里路（推荐）
npx @smithery/cli install todoist-mcp-server在安装过程中，系统会提示您输入您的Todoist API令牌。
如何获取您的Todoist API令牌：
- 首选 Todoist 设置 → 集成
- 向下滚动到“开发者”部分
- 复制您的API令牌
- 在安装过程中，当Smithery提示时，请粘贴它
手动安装
- 克隆此存储库：
git clone https://github.com/shawkatdidar/todoist_claude_mcp_server_v1.0.git
cd todoist_claude_mcp_server_v1.0- 安装依赖项：
pip install -r requirements.txt- 从以下位置获取您的Todoist API令牌： Todoist 设置 > 集成 > 开发者
- 设置你的环境变量：
export TODOIST_API_TOKEN=your_token_here配置
对于Claude Desktop
将此添加到您的Claude桌面配置文件中：
macOS： ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"todoist": {
"command": "python",
"args": ["/path/to/todoist_claude_mcp_server_v1.0/server.py"],
"env": {
"TODOIST_API_TOKEN": "your_token_here"
}
}
}
}对于Smithery（Claude.ai）
使用 Smithery 安装时，设置过程中会提示您输入 TODOIST_API_TOKEN。Smithery 将安全地存储您的令牌，并自动将其提供给 MCP 服务器。
注每位用户都需要自己的Todoist API令牌。该令牌是个人专用的，不应与他人共享。
可用工具
| 工具 | 描述 | |
|---|---|---|
| ------ | ------------- | get_tasks |
获取所有任务，可选择按项目或标签进行过滤 get_projects | ||
| 从Todoist获取所有项目 | get_sections | |
| 获取所有部分，可选择按项目过滤 | get_labels | |
| 从Todoist获取所有标签 | get_comments | |
| 获取特定任务或项目的评论 | create_task | |
| 创建一个新任务，可选择项目、部分、截止日期、优先级和标签 | update_task | |
| 更新现有任务 | complete_task | |
将任务标记为已完成 delete_task |
| 删除任务 |
使用示例
- 安装后，您可以向Claude提问：
- “我今天的任务是什么？”
- “创建一个优先级为3的购买杂货任务”
- “显示我所有的项目”
- “完成任务 \[任务ID\]”
“将任务\[task_id\]的截止日期更新为2025年12月31日”
- 要求
- Python 3.10+
- httpx 版本 >= 0.27.0
- python-dotenv >= 1.0.0
- mcp >= 0.1.0（可翻译为：mcp 版本大于等于 0.1.0）
坚韧性（或持久性）版本 >= 8.2.0
许可证
麻省理工学院（MIT）
作者