MCP Apple Reminders

这是一个用于与macOS上的Apple Reminders应用交互的Model Context Protocol (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助手能够通过Model Context Protocol管理提醒。

开发

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

要求

• macOS（需要用于Apple Reminders集成）
• Node.js 16+
• 配置了至少一个列表的Apple Reminders应用

许可证

MIT