Things MCP Server

Things MCP 服务器

此模型上下文协议 (MCP)服务器允许您使用 Claude Desktop 与Things 应用程序中的任务管理数据进行交互。您可以要求 Claude 创建任务、分析项目、帮助管理优先级等等。

该服务器利用Things.py库和Things URL Scheme 。

特征

• 访问所有主要事物列表（收件箱、今日、即将发生等）
• 项目和区域管理
• 标签操作
• 高级搜索功能
• 最近项目追踪
• 详细的物品信息，包括清单
• 支持嵌套数据（区域内的项目、项目内的待办事项）

安装（适用于 Claude Desktop）

1. 先决条件

• Python 3.12+
• 克劳德桌面
• Things 3（必须在“设置”->“通用”中打开“启用 Things URL”）

2. 如果尚未安装 uv，请安装：

然后重新启动您的终端。

3. 克隆此存储库：

4. 安装所需的 Python 包：

5. 编辑Claude桌面配置文件：

将 Things 服务器添加到配置文件的 mcpServers 键中（确保更新安装这些文件的文件夹的路径）：

重新启动 Claude 桌面应用程序。

Claude Desktop 的使用示例

• “我今天的待办事项清单上有什么？”
• “为下周的海滩度假制定一份打包清单，包括打包清单。”
• “使用艾森豪威尔矩阵评估我当前的待办事项。”
• “帮助我使用 Things 进行 GTD 风格的每周回顾。”

尖端

• 在 Claude 中创建一个项目，其中包含自定义说明，解释如何使用 Things 以及组织区域、项目、标签等。告诉 Claude 创建新任务时您希望包含哪些信息（例如，要求它在任务描述中包含相关详细信息可能会有所帮助）。
• 尝试添加另一个允许 Claude 访问您日历的 MCP 服务器。这样您就可以让 Claude 在日历上为特定任务预留时间，根据即将发生的日历事件（例如会议准备）创建待办事项等等。

可用工具

列表视图

• get-inbox - 从收件箱获取待办事项
• get-today - 获取今天到期的待办事项
• get-upcoming - 获取即将发生的待办事项
• get-anytime - 从 Anytime 列表中获取待办事项
• get-someday - 从 Someday 列表中获取待办事项
• get-logbook - 获取已完成的待办事项
• get-trash - 获取已删除的待办事项

基本操作

• get-todos - 获取待办事项，可选择按项目进行过滤
• get-projects - 获取所有项目
• get-areas - 获取所有区域

标签操作

• get-tags获取所有标签
• get-tagged-items - 获取带有特定标签的项目

搜索行动

• search-todos - 按标题/注释进行简单搜索
• search-advanced - 具有多个过滤器的高级搜索

基于时间的操作

• get-recent - 获取最近创建的项目

工具参数

待办事项

• project_uuid （可选）- 按项目过滤待办事项
• include_items （可选，默认值：true）- 包含清单项目

获取项目/获取区域/获取标签

• include_items （可选，默认值：false）- 包含所含项目

高级搜索

• status - 按状态过滤（未完成/已完成/已取消）
• start_date - 按开始日期过滤 (YYYY-MM-DD)
• deadline - 按截止日期过滤（YYYY-MM-DD）
• tag - 按标签过滤
• area - 按区域 UUID 过滤
• type - 按项目类型过滤（待办事项/项目/标题）

获取最近

• period - 时间段（例如，“3d”、“1w”、“2m”、“1y”）

故障排除

服务器包括以下错误处理：

• 无效的 UUID
• 缺少必需参数
• 事物数据库访问错误
• 数据格式错误

所有错误都会被记录下来并返回描述性消息。要从 Claude Desktop 查看 MCP 日志，请在终端中运行以下命令：