Apple Reminders

🚀 MCP 蘋果提醒事項

MCP 蘋果提醒事項是一個基於 Model Context Protocol (MCP) 的服務器，用於與 macOS 上的蘋果提醒事項應用進行交互。它為 AI 助手提供了標準化接口，讓用戶可以更便捷地管理提醒事項。

🚀 快速開始

本項目可通過特定配置與 Claude Desktop 結合使用，NPX 方式即將推出。以下是詳細配置步驟：

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

✨ 主要特性

• 列表管理：查看你蘋果提醒事項應用程序中的所有提醒事項列表。
• 獲取提醒事項：獲取特定列表中的所有提醒事項。
• 創建提醒事項：創建新的提醒事項，帶有標題、截止日期和備註。
• 完成提醒事項：將提醒事項標記為已完成。
• 刪除提醒事項：從列表中移除提醒事項。
• 日期處理：正確處理截止日期的 ISO 格式。

📚 詳細文檔

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 管理提醒事項。

📦 安裝指南

要求

• macOS（蘋果提醒事項集成所需的必要條件）
• Node.js 16+
• 已配置至少一個列表的蘋果提醒事項應用

開發

該項目使用 TypeScript 和 MCP SDK。要擴展功能，請修改 src/index.ts 中的工具以及 src/reminders.ts 中的 AppleScript 函數。

📄 許可證

本項目採用 MIT 許可證。