🚀 MCP 苹果提醒事项
MCP 苹果提醒事项是一个基于 Model Context Protocol (MCP) 的服务器，它能让你在 macOS 系统上与苹果提醒事项应用进行交互，为你提供便捷的提醒事项管理体验。
✨ 主要特性
- 列表管理：可查看苹果提醒事项应用程序中的所有提醒事项列表。
- 获取提醒事项：能获取特定列表中的所有提醒事项。
- 创建提醒事项：支持创建新的提醒事项，可附带标题、截止日期和备注。
- 完成提醒事项：能将提醒事项标记为已完成。
- 删除提醒事项：可从列表中移除提醒事项。
- 日期处理：能正确处理截止日期的 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 提供以下工具以与苹果提醒事项交互：
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 管理提醒事项。
🚧 开发说明
该项目使用 TypeScript 和 MCP SDK。要扩展功能，请修改 src/index.ts 中的工具以及 src/reminders.ts 中的 AppleScript 函数。
⚠️ 要求说明
- macOS（苹果提醒事项集成所需的必要条件）
- Node.js 16+
- 已配置至少一个列表的苹果提醒事项应用
📄 许可证
MIT