🚀 MCP 苹果提醒事项

MCP 苹果提醒事项是一个基于 Model Context Protocol (MCP) 的服务器，用于与 macOS 上的苹果提醒事项应用进行交互。它为 AI 助手提供了标准化接口，让用户可以更便捷地管理提醒事项。

🚀 快速开始

本项目可通过特定配置与 Claude Desktop 结合使用，NPX 方式即将推出。以下是详细配置步骤：

与 Claude Desktop 结合使用

将以下内容添加到你的 claude_desktop_config.json 文件中：

{
  "mcpServers": {
    "apple-reminders": {
      "command": "node",
      "args": [
        "/path/to/mcp-apple-reminders/dist/index.js"
      ]
    }
  }
}

NPX（即将推出）

{
  "mcpServers": {
    "apple-reminders": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-apple-reminders"
      ]
    }
  }
}

✨ 主要特性

• 列表管理：查看你苹果提醒事项应用程序中的所有提醒事项列表。
• 获取提醒事项：获取特定列表中的所有提醒事项。
• 创建提醒事项：创建新的提醒事项，带有标题、截止日期和备注。
• 完成提醒事项：将提醒事项标记为已完成。
• 删除提醒事项：从列表中移除提醒事项。
• 日期处理：正确处理截止日期的 ISO 格式。

📚 详细文档

API

该服务器通过 MCP 提供以下工具以与苹果提醒事项交互：

getLists

返回所有提醒事项列表。

getReminders

从特定列表中获取提醒事项。

• 参数:
  • listName（必需）：提醒事项列表的名称

createReminder

创建一个新的提醒事项。

• 参数:
  • listName（必需）：提醒事项列表的名称
  • title（必需）：提醒事项的标题
  • dueDate（可选）：提醒事项的截止日期（ISO 格式："YYYY-MM-DDTHH:MM:SS.sssZ"）
  • notes（可选）：提醒事项的备注

completeReminder

将提醒事项标记为已完成。

• 参数:
  • listName（必需）：提醒事项列表的名称
  • reminderName（必需）：要完成的提醒事项的名称

deleteReminder

删除一个提醒事项。

• 参数:
  • listName（必需）：提醒事项列表的名称
  • reminderName（必需）：要删除的提醒事项的名称

🔧 技术细节

此 MCP 服务器使用 AppleScript 与 macOS 上的苹果提醒事项应用交互。它为 AI 助手提供了一个标准化接口，以便通过 Model Context Protocol 管理提醒事项。

📦 安装指南

要求

• macOS（苹果提醒事项集成所需的必要条件）
• Node.js 16+
• 已配置至少一个列表的苹果提醒事项应用

开发

该项目使用 TypeScript 和 MCP SDK。要扩展功能，请修改 src/index.ts 中的工具以及 src/reminders.ts 中的 AppleScript 函数。

📄 许可证

本项目采用 MIT 许可证。