MCP Apple Reminders

一个用于在 macOS 上与 Apple Reminders 交互的模型上下文协议 (MCP) 服务器。

功能

• 列表管理: 查看 Apple Reminders 应用中的所有提醒列表
• 提醒检索: 从特定列表获取所有提醒
• 创建提醒: 创建带有标题、截止日期和备注的新提醒
• 完成提醒: 将提醒标记为已完成
• 删除提醒: 从列表中删除提醒
• 日期处理: 正确处理截止日期的 ISO 日期格式

配置

与 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"
      ]
    }
  }
}

API

该服务器公开以下 MCP 工具，用于与 Apple Reminders 交互：

getLists

返回所有提醒列表。

getReminders

返回来自特定列表的提醒。

• 参数：
  • listName (必需): 提醒列表的名称

createReminder

创建一个新的提醒。

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

completeReminder

将提醒标记为已完成。

• 参数：
  • listName (必需): 提醒列表的名称
  • reminderName (必需): 要完成的提醒的名称

deleteReminder

删除一个提醒。

• 参数：
  • listName (必需): 提醒列表的名称
  • reminderName (必需): 要删除的提醒的名称

工作原理

此 MCP 服务器使用 AppleScript 与 macOS 上的 Apple Reminders 应用交互。 它提供了一个标准化的接口，供 AI 助手通过模型上下文协议管理提醒。

开发

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

要求

• macOS（Apple Reminders 集成所必需）
• Node.js 16+
• Apple Reminders 应用已配置至少一个列表

许可证

MIT