Apple Reminders

🚀 MCP アップルリマインダー

macOS 上のアップルリマインダーアプリとやり取りするための Model Context Protocol (MCP) サーバーです。このサーバーを使用することで、アップルリマインダーの各種操作を効率的に行うことができます。

✨ 主な機能

• リスト管理：アップルリマインダーアプリ内のすべてのリマインダーリストを表示します。
• リマインダー取得：特定のリスト内のすべてのリマインダーを取得します。
• リマインダー作成：タイトル、期限、メモ付きの新しいリマインダーを作成します。
• リマインダー完了：リマインダーを完了済みとしてマークします。
• リマインダー削除：リストからリマインダーを削除します。
• 日付処理：期限の 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"
      ]
    }
  }
}

📚 ドキュメント

このサーバーは 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 以上
• 少なくとも 1 つのリストが設定されたアップルリマインダーアプリ

📄 ライセンス

MIT