使用说明
Todoist MCP服务器
用于Todoist任务管理的MCP服务器。为任务、项目和标签提供12个工具。
特性
- 任务:创建、列出、更新、完成、重新打开和删除任务
- 项目:列出并创建项目,包括子项目
- 标签:列出任务组织并创建标签
- 过滤器:支持Todoist过滤器语法(
today,overdue,p1等等) - 自然语言日期:使用
tomorrow,next Monday,every week等等。
安装
选项1:uvx(推荐)
零安装方法使用 紫外线.添加到 ~/.claude.json:
{
"mcpServers": {
"todoist": {
"command": "uvx",
"args": ["--from", "git+https://github.com/IAMSamuelRodda/todoist-mcp", "todoist-mcp"],
"env": {
"TODOIST_API_TOKEN": "your-api-token"
}
}
}
}
选项2:本地克隆
mkdir -p ~/.claude/mcp-servers
git clone https://github.com/IAMSamuelRodda/todoist-mcp.git ~/.claude/mcp-servers/todoist-mcp
cd ~/.claude/mcp-servers/todoist-mcp
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt
添加到 ~/.claude.json:
{
"mcpServers": {
"todoist": {
"command": "~/.claude/mcp-servers/todoist-mcp/.venv/bin/python",
"args": ["~/.claude/mcp-servers/todoist-mcp/todoist_mcp.py"],
"env": {
"TODOIST_API_TOKEN": "your-api-token"
}
}
}
}
获取您的API代币
- 打开Todoist(网络或应用程序)
- 首选 设置 → 集成 → 开发者
- 复制您的 API令牌
更新中
uvx用户
uv cache clean todoist-mcp
本地克隆用户
cd ~/.claude/mcp-servers/todoist-mcp
git pull
source .venv/bin/activate
pip install -r requirements.txt
可用工具
| 工具 | 说明 |
|---|---|
todoist_list_projects |
列出所有项目 |
todoist_get_project |
获取项目详细信息 |
todoist_create_project |
创建新项目 |
todoist_list_tasks |
使用筛选器列出任务 |
todoist_get_task |
获取任务详细信息 |
todoist_create_task |
创建新任务 |
todoist_update_task |
更新任务 |
todoist_complete_task |
标记任务完成 |
todoist_reopen_task |
重新打开已完成的任务 |
todoist_delete_task |
删除任务 |
todoist_list_labels |
列出所有标签 |
todoist_create_label |
创建新标签 |
使用示例
配置后,您可以询问Claude:
- “显示我今天的任务”
- “创建一个任务来审查下周五到期的季度报告”
- “列出我的所有项目”
- “将任务123456789标记为已完成”
- “我的逾期任务是什么?”
- “在我的工作项目中创建高优先级任务”
筛选器语法
这 todoist_list_tasks 该工具支持Todoist的过滤语法:
today-今天到期的任务tomorrow-明天到期的任务overdue-逾期任务p1,p2,p3,p4-按优先级筛选no due date-没有截止日期的任务7 days-未来7天内到期的任务@label_name-带有特定标签的任务#project_name-特定项目中的任务
许可证
麻省理工学院