MCP 苹果提醒事项

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

特征

• 列表管理：查看 Apple 提醒事项应用中的所有提醒事项列表

• 提醒检索：从特定列表中获取所有提醒

• 创建提醒：创建带有标题、截止日期和注释的新提醒

• 完成提醒：将提醒标记为已完成

• 删除提醒：从列表中删除提醒

• 日期处理：正确处理到期日的 ISO 日期格式

Related MCP server: MCP Apple Calendars

配置

与 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 提醒事项进行交互：

获取列表

返回所有提醒列表。

获取提醒

从特定列表返回提醒。

• 参数：

  • listName （必填）：提醒列表的名称

创建提醒

创建新的提醒。

• 参数：

  • listName （必填）：提醒列表的名称

  • title （必填）：提醒的标题

  • dueDate （可选）：提醒的截止日期（ISO 格式：“YYYY-MM-DDTHH:MM:SS.sssZ”）

  • notes （可选）：提醒的注释

完成提醒

将提醒标记为已完成。

• 参数：

  • listName （必填）：提醒列表的名称

  • reminderName （必填）：需要完成的提醒的名称

删除提醒

删除提醒。

• 参数：

  • listName （必填）：提醒列表的名称

  • reminderName （必填）：要删除的提醒的名称

工作原理

该 MCP 服务器使用 AppleScript 与 macOS 上的 Apple 提醒事项应用进行交互。它通过模型上下文协议 (MCP) 为 AI 助手管理提醒事项提供了标准化接口。

发展

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

要求

• macOS（Apple Reminders 集成所需）

• Node.js 16+

• Apple 提醒事项应用至少配置了一个列表

执照

麻省理工学院