macOS Reminders.app を操作する MCP (Model Context Protocol) サーバー。
EventKit (Swift CLI) をバックエンドとして使用し、繰り返し・場所ベース通知など高度な機能に対応。
| ツール | 説明 |
|---|---|
list_reminder_lists |
リマインダーのリスト一覧を取得 |
get_reminders |
指定したリストのリマインダー一覧を取得 |
add_reminder |
新しいリマインダーを追加 |
complete_reminder |
リマインダーを完了にする |
delete_reminder |
リマインダーを削除 |
update_reminder |
リマインダーの内容を更新（名前、メモ、期日） |
| ツール | 説明 |
|---|---|
set_priority |
優先度を設定（0=なし, 1=高, 5=中, 9=低） |
set_flag |
フラグを設定/解除 |
set_remind_date |
通知日時を設定 |
| ツール | 説明 |
|---|---|
get_recurrence |
繰り返しルールを取得 |
set_recurrence |
繰り返しルールを設定（日次/週次/月次/年次） |
clear_recurrence |
繰り返しルールを解除 |
| ツール | 説明 |
|---|---|
get_location |
場所情報を取得 |
set_location |
場所ベースの通知を設定（到着時/出発時） |
clear_location |
場所ベース通知を解除 |
| 機能 | 状態 | 備考 |
|---|---|---|
| タグ | 未対応 | EventKit / AppleScript ともに API 未公開（#4） |
| フラグ | AppleScript | EventKit に isFlagged プロパティが存在しないため AppleScript で処理 |
TypeScript MCP Server (Bun)
├─ Swift CLI (EventKit) → メイン: 全操作を担当
└─ osascript (AppleScript) → フォールバック: フラグ設定のみ
Swift CLI ヘルパー (swift-helper/) は EventKit 経由で Reminders.app を操作し、JSON で結果を返す。
TypeScript MCP サーバー (src/index.ts) が CLI を呼び出して Claude との通信を仲介する。
- macOS 14 (Sonoma) 以上
- Bun v1.0 以上
- Swift 5.9 以上（Xcode 付属）
- Reminders.app へのアクセス権限
git clone https://github.com/r4sd/apple-reminders-mcp.git
cd apple-reminders-mcp
# 依存パッケージをインストール
bun install
# Swift CLI ヘルパーをビルド
cd swift-helper && swift build -c release && cd ..初回実行時に Reminders.app へのアクセス許可ダイアログが表示されます。
claude mcp add apple-reminders-mcp -- bun /path/to/apple-reminders-mcp/src/index.ts~/Library/Application Support/Claude/claude_desktop_config.json に追加：
{
"mcpServers": {
"apple-reminders-mcp": {
"command": "bun",
"args": ["/path/to/apple-reminders-mcp/src/index.ts"]
}
}
}# MCP サーバー起動
bun src/index.ts
# Swift CLI 単体テスト
swift-helper/.build/release/reminders-helper list-lists
swift-helper/.build/release/reminders-helper get-reminders --list "Backlog"MIT