使用说明
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_快速尝试
- 打开快速输入面板
- 参数：标题、注释、自动填充