关键词

任务管理Things 3AI 自动化生产力工具LLM 集成

项目简介

Things3-MCP 是一个创新的 MCP 服务器，旨在弥合大型语言模型（LLM）与您个人任务管理工具 Things 3 之间的鸿沟。通过部署此服务器，您可以使用自然语言与 Things 3 中的任务、项目、区域和标签进行交互，从而极大地提升您的生产力工作流。无论是创建详细任务、分析项目状态、实施 GTD 流程，还是管理优先级，Things3-MCP 都能让 AI 成为您高效的个人助理。

主要功能点

  • 自然语言任务创建与管理：通过简单的对话，创建包含标题、备注、截止日期和标签的复杂任务，并将其分配到 Things 3 的任何列表、项目或区域。
  • 智能任务分析：让 AI 分析您的项目列表、关注领域和待办事项，提供深入见解，帮助您更好地理解和规划工作。
  • GTD 与生产力工作流：支持 LLM 辅助您实施 Getting Things Done (GTD) 或其他生产力及优先级管理系统。
  • 无缝集成 Things 3 数据：直接读写 Things 3 的数据，无需手动同步或导出。
  • 全面访问 Things 列表：可访问收件箱、今天、即将到来、任何时候、某天、日志簿等所有主要列表。
  • 项目与区域管理：支持创建、更新项目和区域，并将任务或项目分配到特定容器。
  • 标签操作与高级搜索：管理任务和项目的标签，并进行多条件高级搜索。
  • 随机抽样与内容丰富：提供随机抽样功能，帮助 LLM 逐步优化任务描述、添加上下文、分解子任务等。

安装步骤

在开始之前，请确保您的系统满足以下先决条件：

  • Python 3.12+
  • Claude Desktop (或其他兼容 MCP 的 LLM 客户端)
  • MacOS 版 Things 3

步骤 1：安装 Things3-MCP 包

推荐方式：通过 PyPI 在虚拟环境中安装

  1. 打开终端，创建一个 Python 虚拟环境（如果尚未创建）： 'python3 -m venv ~/.venvs/things3-mcp-env'
  2. 激活虚拟环境： 'source ~/.venvs/things3-mcp-env/bin/activate'
  3. 安装 Things3-MCP 服务器包： 'pip install Things3-MCP-server==2.0.6'

步骤 2：配置 Claude Desktop

你需要编辑 Claude Desktop 的配置文件，告诉它如何启动 Things3-MCP 服务器。

  1. 打开 Claude Desktop 配置文件： 'code ~/Library/Application\ Support/Claude/claude_desktop_config.json' （如果没有 'code' 命令，请使用 'open -e' 或您喜欢的文本编辑器打开该路径下的文件。）
  2. 在 JSON 文件的 'mcpServers' 字段中添加一个新的 "things" 服务器配置。

MCP客户端配置信息说明 (JSON格式):

MCP客户端需要以下配置来连接Things3-MCP服务器。请根据您是 PyPI 安装还是源代码安装，选择正确的 'command' 参数：

  • 'server name' (服务器名称): 任意选择一个名称来标识您的Things服务器，例如 '"things"'。
  • 'command' (启动命令):
    • PyPI 安装用户: 设置为您的 Python 虚拟环境中 'Things3-MCP-server' 可执行文件的绝对路径。例如：'"~/.venvs/things3-mcp-env/bin/Things3-MCP-server"'。
    • 源代码安装用户: 设置为 '"uv"'。
  • 'args' (启动参数):
    • PyPI 安装用户: 无需此参数。
    • 源代码安装用户: 这是一个参数列表，用于告诉 'uv' 如何在您的仓库目录中运行服务器。例如：'["--directory", "/ABSOLUTE/PATH/TO/PARENT/FOLDER/Things3-MCP", "run", "Things3-MCP-server"]'。请将 '/ABSOLUTE/PATH/TO/PARENT/FOLDER/Things3-MCP' 替换为您实际的仓库路径。

步骤 3：重启 Claude Desktop

保存配置文件后，完全关闭并重新打开 Claude Desktop 应用，以启用新的 Things 3 集成。

基本使用方法

一旦配置完成并重启 Claude Desktop，您就可以开始使用自然语言与 Things 3 互动了。在 Claude Desktop 中，您可以通过提及 Things 功能或直接提问来调用服务器提供的工具：

  • “我今天有什么待办事项？” (查询今日任务)
  • “创建一个待办，提醒我为下周的每次一对一会议做准备。” (创建任务)
  • “使用艾森豪威尔矩阵评估我今天的所有待办事项。” (任务分析)
  • “帮我使用 Things 进行一次 GTD 风格的每周回顾。” (工作流辅助)

提示：

  • 在 Claude 中创建一个自定义指令的项目，解释您如何使用 Things，如何组织区域、项目、标签等。告诉 Claude 在创建新任务时需要包含哪些信息（例如，要求它在任务描述中包含相关详细信息，是否使用表情符号等）。
  • 尝试将其与其他 MCP 服务器（例如访问您日历的服务器）结合使用。这将允许您要求 Claude 为特定任务安排时间，创建与即将到来的日历事件相关的任务（例如，为会议做准备）等。

信息

分类

桌面与硬件

访问项目