Todoist MCP 服务器 (Python)
一个用 Python 编写的 Todoist MCP 服务器,使用了Todoist Python API 。我最初使用 Claude 将这个TypeScript Todoist MCP 服务器转换为 Python 版本来创建这个服务器。随着我尝试使用 Claude 来帮助管理任务,我正在逐步修改和添加功能以适应我的工作流程。
安装
先决条件
- Python 3.10+
- UV 包管理器(安装指南)
- Todoist API令牌
获取 Todoist API 令牌
- 登录您的 Todoist 帐户
- 前往“设置”→“集成”
- 在“开发者”下找到您的 API 令牌
使用 Claude Desktop 进行配置
将 MCP 服务器添加到您的 claude_desktop_config.json 中,
{
"mcpServers": {
"todoist": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/mikemc/todoist-mcp-server",
"todoist-mcp"
],
"env": {
"TODOIST_API_TOKEN": "your_todoist_api_token"
}
}
}
}
或者,从本地副本运行,
{
"mcpServers": {
"todoist": {
"command": "uvx",
"args": [
"--from",
"/absolute/path/to/todoist-mcp-server",
"todoist-mcp"
],
"env": {
"TODOIST_API_TOKEN": "your_todoist_api_token"
}
}
}
}
可用工具
要查看当前可用的工具,请运行
# With GNU grep installed as ggrep (as with `brew install grep` on Mac)
ggrep -Po '(?<=^mcp.tool\(\)\()([^)]+)' src/main.py
截至 2025 年 5 月 26 日,
- 项目
todoist_get_projects
todoist_get_project
todoist_add_project
todoist_update_project
todoist_delete_project
- 章节
todoist_get_sections
todoist_get_section
todoist_add_section
todoist_update_section
todoist_delete_section
- 任务
todoist_get_task
todoist_get_tasks
todoist_filter_tasks
todoist_add_task
todoist_update_task
todoist_complete_task
todoist_uncomplete_task
todoist_move_task
todoist_delete_task
- 评论
todoist_get_comment
todoist_get_comments
todoist_add_comment
todoist_update_comment
todoist_delete_comment
执照
本项目遵循 MIT 许可证。详情请参阅LICENSE文件。