任务管理MCP服务器

一个连接todo.txt文件和AI助手的模型上下文协议服务器,通过自然语言管理任务,同时保持纯文本的简单性和可移植性。

  • by danielmeint
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 danielmeint/todo-txt-mcp

使用说明

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报告和功能请求 通过 GitHub问题.

许可证

麻省理工学院-见 许可证.