Todo.txt MCP Server

Todo.txt MCP 服务

一个 Model Context Protocol 服务，可将 todo.txt 文件连接到 Claude 等 AI 助手。通过自然语言管理任务，同时保留纯文本的简洁性和可移植性。

安装

# 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 Windows：%APPDATA%\Claude\claude_desktop_config.json

{
    "mcpServers": {
        "todo-txt": {
            "command": "uvx",
            "args": [
                "todo-txt-mcp"
            ]
        }
    }
}

重启 Claude Desktop。工具图标会确认服务已连接。

自定义 todo.txt 位置

{
    "mcpServers": {
        "todo-txt": {
            "command": "uvx",
            "args": [
                "todo-txt-mcp",
                "/path/to/your/todo.txt"
            ]
        }
    }
}

todo.sh 集成

如果你使用 todo.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	按上下文筛选（@标签）
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

贡献

请参阅 CONTRIBUTING.md 了解指南。欢迎通过 GitHub Issues 提交错误报告和功能请求。

许可证

MIT——详见 LICENSE。