Todo.txt MCP服务器
](https://badge.fury.io/py/todo-txt-mcp)  
A. 模型上下文协议 连接的服务器 todo.txt 文件 像克劳德这样的人工智能助手。通过自然语言管理您的任务，同时保持 纯文本。
安装
# Recommended
uv tool install todo-txt-mcp
# Or run directly without installing
uvx todo-txt-mcp
# Alternatives
pipx install todo-txt-mcp
pip install todo-txt-mcp配置
添加到您的Claude Desktop配置中：
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json 视窗: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"todo-txt": {
"command": "uvx",
"args": [
"todo-txt-mcp"
]
}
}
}重新启动克劳德桌面。工具图标确认服务器已连接。
自定义todo.txt位置
{
"mcpServers": {
"todo-txt": {
"command": "uvx",
"args": [
"todo-txt-mcp",
"/path/to/your/todo.txt"
]
}
}
}todo.sh集成
如果你使用 一切.sh，服务器会自动检测您的配置 ~/.todo/config, ~/.todo.cfg，或标准系统位置。
环境变量
TODO_MCP_TODO_FILE_PATH=/path/to/todo.txt
TODO_MCP_BACKUP_ENABLED=true
TODO_MCP_MAX_FILE_SIZE=10000000可用工具
| 工具 | 说明 |
|---|---|
list_todos | 使用可选过滤器列出待办事项 |
add_todo | 创建新待办事项 |
complete_todo | 将待办事项标记为已完成 |
update_todo | 修改现有待办事项 |
delete_todo | 删除待办事项 |
search_todos | 按文本查找待办事项 |
filter_by_priority | 按优先级筛选（A-Z） |
filter_by_project | 按项目筛选（+标签） |
filter_by_context | 按上下文筛选（@tag） |
get_statistics | 获取待办事项统计信息 |
Todo.txt格式
完全兼容 todo.txt规范:
(A) Call Mom +family @phone
x 2025-05-31 2025-05-30 (B) Buy groceries +shopping @errands
Write project proposal +work @computer贡献
看 贡献.md 作为指导方针。欢迎Bug报告和功能请求 通过 .
许可证
麻省理工学院-见 许可证.
