Things 3 MCP服务器
一个模型上下文协议(MCP)服务器,提供与macOS上的Things 3和日历应用程序的集成。该服务器允许AI助手和其他MCP客户端通过标准化的界面与您的Things 3任务、项目和区域进行交互。
特性
做管理
- 添加到剂量:创建带有标题、注释、截止日期、标签的新任务,并将其分配给特定的列表、项目或区域
- 待办事项列表:从任何列表(收件箱、今天、任何时候、即将到来、某一天、日志、垃圾桶)或特定项目/区域检索任务
- 更新到Dos:修改现有任务(标题、注释、截止日期、标签)
- 完成到剂量:将任务标记为已完成
- 删除到待办事项:将任务移至回收站
项目管理
- 添加项目:使用注释、标记和区域分配创建新项目
- 列出项目:查看按状态(打开、已完成、全部)或区域筛选的所有项目
区域管理
- 添加区域:创建新的责任领域
- 列表区域:查看所有区域
附加功能
- 搜索:搜索所有待办事项、项目和领域
- 每日概览:获取今天任务和计数的摘要
- 快速入口:打开Things 3的快速输入面板,其中包含可选的预填充内容
需求
- macOS(Things 3仅适用于Mac)
- 东西3安装
- Python 3.7+
- MCP包
安装
- 克隆此存储库或下载服务器文件
- 安装依赖项:
pip install -r requirements.txt- (可选)作为软件包安装:
pip install -e .配置
适用于克劳德桌面
将以下内容添加到您的Claude Desktop配置文件中:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"things3": {
"command": "python3",
"args": ["/path/to/things3_server.py"],
"env": {}
},
"calendar": {
"command": "python3",
"args": ["/path/to/calendar_server.py"]
}
}
}对于其他MCP客户端
使用提供的 mcp.json 配置文件或直接运行:
python things3_server.py服务器通过stdin/stdout进行通信,使其与任何MCP客户端兼容。
可用工具
- 东西3_add_todo
- 添加具有可选属性的新待办事项 - 参数:title(必填)、notes、due_date、tags、list、project、area
- things3_list_todos
- 列出特定列表、项目或区域中的待办事项 - 参数:列表、项目、面积、限制
- 事情3_完成_待办事项
- 将待办事项标记为已完成 - 参数:标题(必填)
- things3_update_todo
- 更新现有待办事项 - 参数:title(必填)、new_title、notes、due_date、tags
- 事情3_delete_todo
- 将待办事项移至垃圾桶 - 参数:标题(必填)
- things3_add_项目
- 创建新项目 - 参数:标题(必填)、注释、区域、标签、时间
- things3_list_项目
- 列出带有筛选器的项目 - 参数:状态、区域
- 事物3_add_area
- 创建新区域 - 参数:标题(必填)、标签
- 事物3_list_areas
- 列出所有区域 - 无参数
- 东西3_search
- 搜索所有项目 - 参数:查询(必填)、限制
- 事物3_daily_overview
- 获取今天的任务摘要 - 无参数
- 事情3_快速尝试
- 打开快速输入面板 - 参数:标题、注释、自动填充
###
