mcpField
A
apple-reminders

apple-reminders

github.com/nousresearch生産性258.5k370 回インストール今日更新
リポジトリ

apple-reminders について

apple-remindersは、コマンドラインツールremindctlでmacOS上のApple Remindersを管理するスキルです。リマインダーの確認やリスト整理、作成・更新に加え、期限と通知アラームを扱えます。

主な機能

  1. 01日付や状態でリマインダーを確認
  2. 02リマインダーの作成・編集・完了・削除
  3. 03リストの作成と管理
  4. 04期限とアラームを個別に設定
  5. 05JSON・プレーンテキスト・件数形式で出力

活用シーン

  1. 01期限付きの個人タスクを追加
  2. 02期限前の通知を設定
  3. 03期限超過や近日のリマインダーを確認
  4. 04Apple Remindersのリストでタスクを整理

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/nousresearch/hermes-agent --skill apple-reminders

インストール後、Claude Code で/apple-remindersを入力して読み込まれたか確認します。

詳細

Apple Reminders

remindctlを使用して、ターミナルからApple Remindersを直接管理します。タスクはiCloud経由で、すべてのAppleデバイス間で同期されます。

前提条件

  • Reminders.appを搭載したmacOS
  • インストール：brew install steipete/tap/remindctl
  • プロンプトが表示されたら、リマインダーへのアクセスを許可します
  • 確認：remindctl status／許可をリクエスト：remindctl authorize

使用する場面

  • ユーザーが「リマインダー」または「Reminders app」と言及した場合
  • iOSと同期する、期限付きの個人的なToDoを作成する場合
  • Apple Remindersのリストを管理する場合
  • タスクをiPhone／iPadに表示したいとユーザーが希望する場合

使用しない場面

  • エージェントのアラートをスケジュールする場合 → 代わりにcronjobツールを使用します
  • カレンダーの予定 → Apple CalendarまたはGoogle Calendarを使用します
  • プロジェクトのタスク管理 → GitHub Issues、Notionなどを使用します
  • ユーザーが「リマインドして」と言っていても、エージェントのアラートを意味している場合 → まず確認します

クイックリファレンス

リマインダーを表示する
remindctl                    # Today's reminders
remindctl today              # Today
remindctl tomorrow           # Tomorrow
remindctl week               # This week
remindctl overdue            # Past due
remindctl all                # Everything
remindctl 2026-01-04         # Specific date
リストを管理する
remindctl list               # List all lists
remindctl list Work          # Show specific list
remindctl list Projects --create    # Create list
remindctl list Work --delete        # Delete list
リマインダーを作成する
remindctl add "Buy milk"
remindctl add --title "Call mom" --list Personal --due tomorrow
remindctl add --title "Meeting prep" --due "2026-02-15 09:00"
期限時刻とアラーム／事前通知

--dueと--alarmは異なるフィールドです。

  • --dueはリマインダーの期限日時を設定します。
  • --alarmはEventKitのアラーム／通知のトリガーを設定します。時刻指定の期限付きリマインダーでは、デフォルトで期限時刻にアラームが設定される場合がありますが、ユーザーが事前通知を希望する場合は--alarmを明示的に指定してください。

午後2時が期限で、30分前に通知するリマインダーの場合：

remindctl add --title "Hairdresser" --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"

既存のリマインダーを編集する場合：

remindctl edit 87354 --due "2026-05-15 14:00" --alarm "2026-05-15 13:30"

通知が発火する時刻に基づいて、RemindersのUIでは項目が表示されたりグループ化されたりする場合があります。期限時刻が変更されたと決めつけず、JSONで確認してください。

remindctl today --json

期待される形式：

  • dueDate：実際の期限時刻
  • alarmDate：通知／事前通知の時刻

Appleの公開EKReminderドキュメントには、リマインダー固有のプロパティのみが記載されています。アラームのサポートは、EKCalendarItemから継承した動作を、remindctlの--alarmフラグで利用できるようにしたものです。

完了／削除する
remindctl complete 1 2 3          # Complete by ID
remindctl delete 4A83 --force     # Delete by ID
出力形式
remindctl today --json       # JSON for scripting
remindctl today --plain      # TSV format
remindctl today --quiet      # Counts only

日付形式

--dueおよび日付フィルターで使用できる形式：

  • today、tomorrow、yesterday
  • YYYY-MM-DD
  • YYYY-MM-DD HH:mm
  • ISO 8601（2026-01-04T12:34:56Z）

ルール

  1. ユーザーが「リマインドして」と言った場合は、Apple Reminders（スマートフォンと同期）とエージェントのcronjobアラートのどちらかを確認します
  2. 作成前に、リマインダーの内容と期限を必ず確認します
  3. プログラムで解析する場合は--jsonを使用します

コメント

Markdown 対応