MCP Apple 提醒事项

一个用于在 macOS 上与 Apple 提醒事项交互的 Model Context Protocol (MCP) 服务器。

功能

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

配置

与 Claude Desktop 一起使用

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

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

NPX（即将推出）

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

API

该服务器提供了以下 MCP 工具，用于与 Apple 提醒事项进行交互：

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 提醒事项应用进行交互。它通过 Model Context Protocol 为 AI 助手提供了一个标准化接口来管理提醒。

开发

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

要求

• macOS（与 Apple 提醒事项集成所需）
• Node.js 16+
• 至少配置有一个列表的 Apple 提醒事项应用

许可证

MIT