返回 MCP 目录
public公开dns本地运行

Things3

一个提供与Things3集成的MCP服务器,支持任务和项目管理,特别支持与Agenda项目的同步。

article

README

🚀 适用于 Things3 的 MCP 服务器

本 MCP 服务器可与 Things3 集成,借助 MCP 协议,您能够轻松创建和管理任务及项目,尤其支持与 Agenda 项目的同步,为任务管理带来极大便利。

🚀 快速开始

此 MCP 服务器能助力您通过 MCP 协议在 Things3 里高效创建和管理任务及项目,还可实现与 Agenda 项目的同步。

✨ 主要特性

  • 在 Things3 中创建新项目。
  • 利用详细属性创建新待办事项。
  • 同步 Agenda 和 Things3 之间的项目。
  • 列出当前任务和项目。
  • 集成 AppleScript 用于数据检索。

📦 安装指南

  1. 确保已安装 Python 3.8+ 和 Things3。
  2. 克隆此仓库。
  3. 安装依赖项:
pip install -e .

💻 使用示例

基础用法

本服务器提供了多种实用工具,以下是各工具的使用说明:

create-things3-project

在 Things3 中创建新项目,支持以下选项:

  • 标题(必填)
  • 备注
  • 领域
  • 时间
  • 截止日期
  • 标签
  • 完成状态
  • 取消状态

create-things3-todo

在 Things3 中创建新待办事项,支持以下选项:

  • 标题(必填)
  • 备注
  • 时间
  • 截止日期
  • 复查列表
  • 标签
  • 列表
  • 标题
  • 完成状态
  • 取消状态
  • 显示状态

sync-agenda-project

创建一个与 Agenda 项目镜像的 Things3 项目,支持以下选项:

  • 标题(必填)
  • 备注
  • 领域

🔧 技术细节

该服务器运用了以下技术实现其功能:

  • 采用 x-callback-url 在 Things3 中创建项目。
  • 借助 AppleScript 从 Things3 检索数据。
  • 通过 MCP 协议进行通信。

📄 许可证

本项目采用 MIT 许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端